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MODEL D MANUALS: WHERE TO TURN FIRST 


OPERATOR'S GUIDE 


Read this guide first, as it serves as an introduction to the Model D. 
It explains how to set up and use the computer, and how to solve any 
problems you may encounter. Turn next to the MS-DOS User's Guide. 


MS-DOS USER'S GUIDE 


You need an operating system to run the Model D. This guide contains the 
basics that you need to know to run the Model D with the MS-DOS operating 
system. Procedures are presented in an easy-to-follow, step-by-step 


format. Read through the entire guide (it's short) before you begin to 
use MS-DOS. 


MS-DOS REFERENCE MANUAL GUIDE TO BASIC 


This manual describes the features of Before you can write BASIC programs on 
the MS-DOS operating system in a more the Model D, you'll need to learn about 
technical format. You'll discover more GWBASIC. This book explains GWBASIC 
powerful ways to use MS-DOS. Read commands, statements, functions, and 
the Reference Manual after you're variables and the correct syntax for 
comfortable using MS-DOS and are each. It does not teach you how to 
familiar with the basic commands program in GWBASIC. 

outlined in the MS-DOS User's Guide. 
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PREFACE 


ABOUT THIS MANUAL 


This manual describes each MS-DOS command and program. Its organization is 
outlined below. 


Chapter 1 Files 
This chapter describes how to name, protect, and keep track 
of files. It also has details on wildcard characters and 
reserved filenames. 


Chapter 2 Using a Fixed Disk 
This chapter helps you get MS-DOS started on a fixed-disk 
system. It has information on partitioning the fixed disk 
and updating your current version of MS-DOS. 


Chapter 3 Organizing a Fixed Disk 
This chapter describes the basics of directories and 
subdirectories. It presents guidelines for organizing a 
fixed disk. 


Chapter 4 Input and Output 
This chapter presents material on redirecting input and 
output. 

Chapter 5 MS-DOS Commands 


This chapter begins with an explanation of the syntax used 
in this manual to describe MS-DOS commands. You need to 
read it to understand how to type commands. It is followed 
by an alphabetic listing of MS-DOS commands, with their 
purposes, correct syntax, and rules of usage, along with 
examples. 


Chapter 6 


Chapter 7 


Chapter 8 


Chapter 9 


Creating Batch Files 

This chapter discusses batch files and commands to use in 
them. It contains examples of batch files that can save 
you a lot of work. 


Configuring Your System 
This chapter describes configuring your system and lists 
all the options available in a CONFIG.SYS file. 


EDLIN 
This chapter describes EDLIN, the line editor program on 
your MS-DOS disk. 


MS-LINK 

This chapter describes MS-LINK, an MS-DOS utility for 
linking separately produced object modules or creating 
relocatable program modules. 


DEBUG 
This chapter explains how to use the MS-DOS DEBUG utility. 


ANSI Escape Sequences 
This appendix contains information about ANSI standard 
escape sequences. 


MS-DOS Message Directory 
This appendix contains information about on-screen 
messages. 


MS-DOS VERSION 3.10 


MS-DOS Version 3.10 provides both new and expanded capabilities. 


Compared to the 2.11 version of MS-DOS, version 3.10 offers the following new 


commands. 
ATTRIB 
GRAFTABL 
JOIN 
KEYBxx 
LABEL 


SELECT 


SHARE 


2 / Preface 


Sets read-only status to a file. 

Defines additional characters in graphics mode. 
Connects a drive to a directory on another drive. 
Provides keyboard drivers for non-U.S. keyboards. 
Creates, changes, or deletes the volume label on a disk. 


Creates an MS-DOS disk that loads the keyboard driver and country 
code that you want. 


Enables file sharing and locking on a network. 


SUBST Substitutes a drive name for another drive or another drive and 
path. 


VDISK Creates a virtual drive in RAM. 


In addition, some commands have been enhanced or new options have been added. 


BACKUP Now allows you to back up files on a variety of media. 

RESTORE Now allows you to restore files on a variety of media 

SORT Recognizes as equal all versions of a particular letter. 

TREE The /F option tells the TREE command to display filenames as well 


as directories and subdirectories. 


MS-LINK The /X:n option allows up to 1024 segments in a Run File. 


MS-DOS 3.10 allows you to add the CLKDVR, COUNTRY, FCBS, LASTDRIVE, and VDISK 
commands to a CONFIG.SYS file. CLKDVR is the clock driver that activates the 
time-of-day clock in the Model D. CLKDVR allows you to decide whether or not 
you want to turn on the clock. The COUNTRY command controls the displayed 
format of date, time, currency, and case for international applications. FCBS 
controls how many files may be open concurrently, and LASTDRIVE tells MS-DOS 
what is the highest valid disk drive name from A to Z. 


Unlike previous versions of MS-DOS, MS-DOS 3.10 allows you to specify a path to 
a specific command or program that you want to run. 


SUMMARY 


Before using this manual, read the introduction to Chapter 5 to learn how to 
use command syntax. 
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ABOUT FILES 


A file is a collection of related information, such as a program, text, or 
data, stored on disk. Each file on a disk must have a unique name, ideally one 
that describes its contents (see Filenames in this chapter). For example: 


CHAP3.NOV 
NOTES.TOM 
ACCOUNTS.PAY 


HOW MS-DOS KEEPS TRACK OF FILES 


When MS-DOS formats a disk, it sets up two systems to manage files, the 
directory and the File Allocation Table. 


The Directory 


During formatting, MS-DOS prepares the disk to accept files by opening a 
directory. The directory is a running list of all the files you create on 
a disk. 


MS-DOS commands like DEL (to delete a file) or RENAME (to change the name 
of a file) affect the filenames in a directory, but not the actual contents 
of files. For instance, if you type: 


DEL MEMOS.SUE 


you are telling MS-DOS to remove the filename MEMOS.SUE from the current 
directory. 


As far as MS-DOS is concerned, removing a filename from a directory is 
virtually the same as deleting the file. The contents of the file may 
still be on the disk somewhere, but without a listing for the filename, 
MS-DOS cannot retrieve it. In fact, MS-DOS will freely write over the 
nameless file. 


The File Allocation Table 


The other file-management system established during formatting is the File 
Allocation Table. It keeps track of the locations of files. It also 
allocates the free space on your disks for the creation of new files. 
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When you summon a file by typing its name, MS-DOS looks in the directory for 
that filename. If the file is listed there, MS-DOS refers to the File 
Allocation Table for the location of the file to retrieve it. 


THE DIR AND CHKDSK COMMANDS 


The two MS-DOS commands DIR and CHKDSK illustrate how the operating system 
keeps track of files. 


DIR (Show Directory) 


You can call for a list of the files on a disk by using the DIR command. 
If you do not specify a drive, MS-DOS lists the directory of the disk in 
the default drive. For example, if you type DIR by itself, MS-DOS lists 
all the files on the default drive. 


If you type DIR followed by a drive indicator, MS-DOS lists the directory 
of the disk in the drive you specify. For example, DIR B: tells MS-DOS to 
list the directory on Drive B. 


Note: Press RETURN after typing each MS-DOS command to activate it. 
Along with filenames and their filename extensions, a directory lists the 
size of each file in bytes, the dates and times the files were created or 
most recently edited, and the total number of files in the directory. A 


sample directory listing appears below: 


Directory of B:\ 


OUTL I NE TXT 9066 10-15-85 11:00a 

CHAP 1 TXT 19968 11-01-85 9:02a 

CHAP2 TXT 12800 11-08-85 4:16p 

CHAP3 TXT 11990 12-11-85 7:13) 

FINIS TAT 4016 12-17-85 10:00a 
5 File(s) 259690 bytes free 
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Note: On a fixed-disk system, the DIR command lists the files in the 
current directory. For more information, see Chapter 3. 


From a directory listing you can look up the exact name of the file you 
want, so that you can instruct MS-DOS to retrieve it. 


The DIR command also gives you information about any file in a directory. 
For example, if you type: 


DIR INFO.TAX 


MS-DOS displays the name, size, and date created or last edited for the 
file INFO.TAX. 


CHKDSK (Check Disk) 

The CHKDSK command checks and analyzes the directory and the File 
Allocation Table on a disk. MS-DOS produces a status report on the 
contents of the disk, similar to the one below: 

362496 bytes total disk space 

25600 bytes in two hidden files 

309248 bytes in 18 user files 

2/648 bytes available on disk 


393216 bytes total memory 
365264 bytes free 


If CHKDSK detects any errors, you will see a message followed by a status 
report. 


For more information on the CHKDSK command, see Chapter 5. 


FILENAMES AND EXTENSIONS 

Files can contain text, data, or programs. 

Each file on a disk has a unique name, usually consisting of two parts: a 
filename and a filename extension. Together they indicate the contents of the 


file, according to any scheme you choose, as long as you observe the 
conventions below. 
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Filename Conventions 
Certain rules govern the naming of files in MS-DOS: 
o A filename and its extension are separated by a period. 
o A filename can be from 1 to 8 characters long. 


o A filename extension is optional (recommended) and can be from 1 to 3 
characters in length. 


o Characters in filenames and extensions may include both letters and 
numbers. In addition, the following characters are valid in filenames: 


$#&@!1%()-_{}‘~ 


o No spaces may occur within a filename or extension. 


Reserved Filenames 


MS-DOS reserves certain names to refer to devices; these cannot be used as 
filenames. They are as follows: 


Table 1-1 Reserved Filenames 
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Wildcards 


Two characters serve as wildcards in filenames, allowing you greater 
flexibility when managing files in MS-DOS. They are the asterisk (*) and 
the question mark (?). 


The ? Wildcard. A ? in a filename or extension stands for any character in 
that position. 


For example, suppose you have several files that hold medical records. All 
the filenames begin with the same five characters, MEDIC, and they all have 
the extension .REC. The only difference between them is the single 
character or digit that falls after the word MEDIC. For a directory of all 
those files, you can type: 


DIR MEDIC?.REC 
Youll see a directory listing for the files: 


MEDIC2.REC 
MED IC3 .REC 
MED ICA .REC 
MED ICB . REC 
MED ICX . REC 


Note: Any number of ? wildcards may be used in a filename and extension, 
each one standing for a single character. 


The * Wildcard. A * in a filename or extension stands for any one 
character or all the remaining characters in a name or an extension. For 
example, you can type: 


DIR ME*.REC 


MS-DOS lists all the files that have ME as the first two characters, and 
the extension .REC 


MEAT . REC 
MEDIC .REC 
MESS .REC 
MEX .REC 
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If you type DIR MEDIC.* MS-DOS lists all the files named MEDIC with any 
extension: 


MEDIC.REC 
MEDIC.85 

MEDIC.DOC 
MEDIC.FAX 


PROTECTING FILES 


No matter how careful you are with disks, accidents or user errors can cause 
damage to files and possibly destroy them. If you don't take steps to protect 
your files, you might suddenly find yourself with nothing to show for your 
Work. 


Backing Up Files and Verifying the Copies 


Keeping backup copies of your files is the best means of preventing their 

loss. The two MS-DOS commands DISKCOPY and COPY let you make backup copies 
of files. To verify copies made with DISKCOPY, you can use another MS-DOS 
command, DISKCOMP. 


DISKCOPY and DISKCOMP. The DISKCOPY command copies the contents of one 
disk (the source disk) onto a second disk (the target disk). 


MS-DOS carries out the DISKCOPY procedure in two stages. First it checks 
to see whether the target disk is formatted and, if not, formats it. Then 
MS-DOS copies all the files on the source disk onto the target disk. 


WARNING 


The DISKCOPY command overwrites everything on the target disk. Do not use 
DISKCOPY unless you are sure the disk you are copying to has no data on it 
that you want to save. 


The DISKCOPY command cannot be used to copy files to a fixed disk.  Fixed- 
disk users should use COPY *.* instead. (See below, The COPY Command.) 


After making a backup disk with DISKCOPY, you should verify it using 
another MS-DOS command, DISKCOMP. The DISKCOMP command compares the 
original disk against the copy, sector by sector, and makes sure they are 
exactly alike. If they are not, DISKCOMP gives you an error message. 


For more information on DISKCOPY and DISKCOMP, see Chapter 5. 
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The COPY Command and Methods of Verification. Use the COPY command when 
you want to make backup copies of individual files, or when you want to 
copy files to a disk without overwriting everything else on it. 


To copy all the files on a disk to a backup disk, use the COPY command 
along with the * wildcard. Type: 


COPY B:*.* 


This tells MS-DOS you want to copy any file with any extension 
(effectively, all files) on the default drive to the disk in Drive B. 


After copying files with the COPY command, you should verify the copies. 
There are three ways to do this: 


o When you issue the COPY command, you can add the /V option: 
COPY B:*.*/V 


MS-DOS will automatically verify each file as it is copied. (This 
slows the copying procedure somewhat.) 


o After copying files, you can run COMP, an external MS-DOS command, to 
compare the original files against the copies. After inserting the 
MS-DOS disk, type: 

COMP 


MS-DOS prompts you for the filenames you want to compare. 


o The VERIFY command can be set ON or OFF, before you begin the copying 
procedure. Type: 


VERIFY ON 
As long as VERIFY is ON, MS-DOS will check every file that you copy, 
until you turn VERIFY OFF. If the copies are not exact, MS-DOS will 
display an error message. 
For more information on the COPY, COMP, and VERIFY commands, see Chapter 5. 
Note: You can also use the BACKUP and RESTORE commands to backup files. 


For more information, see Chapter 3, or look up these commands in Chapter 
5. 
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Write-Protecting Files 


Another way to protect files is to guard them against being overwritten. 
There are two methods of write-protecting files. 


The Write-Protect Notch and Tab. Covering the notch on a floppy disk with 
opaque tape or an adhesive tab is a mechanical means of keeping the files 
on a disk intact. When the notch is covered, a disk drive can read files 
but cannot write to or change anything on the disk. 


The ATTRIB (Attribute) Command. The ATTRIB command offers another way to 
write-protect files. ATTRIB allows you to give a file the read-only 
attribute. For example: 


ATTRIB +R B:NOTES.TXT 


This gives the file NOTES.TXT on Drive B a read-only status, which means it 
can be read from but not written to or erased. 


To return the file to the read/write status, substitute -R for +R, in the 
line above. 


For more information, see the ATTRIB and CHMOD commands in Chapter 5. 


SUMMARY 


MS-DOS manages files on a disk by listing them in a directory and recording 
their locations in the File Allocation Table. Using the DIR command, you can 
see a listing of all the files in a directory. For a status report on the 
directory and the File Allocation Table, use the CHKDSK command. 


Filenames must follow certain rules in MS-DOS, which reserves several names for 
its own use. The * and ? wildcards may be used to retrieve and edit filenames 
efficiently. 


Backing up files is an essential step that protects your work from damage or 
loss. Two MS-DOS commands, DISKCOPY and COPY, can be used to make backup 
files. You should verify all copies you make, using DISKCOMP for comparing 
entire disk copies, or other verification procedures where applicable. 


Write-protection is another form of safeguarding files. You can cover the disk 


notch to prevent the disk from being written on, or you can use the ATTRIB 
command to assign a read-only status to the disk files. 
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CHAPTER 2 
USING A FIXED DISK 
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ABOUT FIXED DISKS 

If your computer has a fixed-disk drive, there are two things you need to do 
before you use it. First, you need to prepare it for use. Second, you should 
decide how you want to organize it. This chapter describes preparing a fixed 
disk for use. For information on organizing a fixed disk, see Chapter 3. 
Preparing a fixed disk requires the following steps: 

o  Deciding how many operating systems you want to use. 

o Creating a partition for MS-DOS. 

o Formatting the MS-DOS partition. 

o Making a working copy of the MS-DOS Master disk. 

o Copying the MS-DOS files to the MS-DOS partition. 

In addition, you can create a partition for an operating system other than 
MS-DOS. To install another operating system, you'll need to refer to the 
documentation that came with it. 

PARTITIONING A FIXED DISK WITH THE FDISK COMMAND 

On a fixed disk, partitions are made of contiguous groups of cylinders whose 
boundaries are defined in terms of starting and ending cylinder numbers. The 
number and size of cylinders vary from drive to drive, depending on type and 
Capacity. 

A partition reserves space for an operating system. Each operating system 
resides in its own partition. You can have as many as four partitions on a 


fixed-disk system. 


Before MS-DOS can use a fixed disk, you must create and format a partition for 
it. You do this with the FDISK command. The FDISK command is used to: 


O Create a partition for MS-DOS. 

o Change the active partition. 

o Display partition information. 

o Delete the MS-DOS partition. 

This section describes how to carry out all the FDISK operations. 


Note: You can also use PREPARE.COM on the Diagnostics Disk to prepare a fixed 
disk. See the Operator's Guide for more information. 
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Creating the MS-DOS Partition 
If you're going to use MS-DOS exclusively with your fixed disk, see below, 
One Partition. If you're going to use more than one operating system, see 
below, More Than One Partition. 
One Partition. If MS-DOS is the only operating system you plan to use, the 
procedure is simple. You create one partition for MS-DOS, format it, and 
copy the MS-DOS files on it. 
Folow these steps to create the MS-DOS partition: 
1. Start up the computer with a working copy of MS-DOS in Drive A. 


2. At the A» prompt, type: fdisk and press RETURN. 
The FDISK Options Menu appears on the screen. 


FDISK Options 

Choose one of the following: 
1. Create DOS Partition 

2. Change Active Partition 
3. Delete DOS Partition 

4. Display Partition Data 
Enter choice: [1] 


Press Esc to return to DOS. 


3. Press RETURN to choose option 1, Create DOS Partition. You see the 
message: 


Create DOS Partition 


Do you wish to use the entire fixed 
disk FOr DOS (YIN) uuu. ne hue a9 aee 1-2 3 S478 sane [Y] 


Press Esc to return to FDISK Options 
4. Press RETURN again to allocate the entire fixed disk for MS-DOS. 


You now have a partition for MS-DOS. For information on how to format 
the partition, see below, Formatting the MS-DOS Partition. 


More Than One Partition. If you are planning to use more than one 
operating system now, or expect to do so in the future, you must allocate 
storage space on the fixed disk for each one. In this case, you need to 
establish the starting cylinder and the size of the MS-DOS partition. 
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Some considerations follow: 


o Despite the large amount of storage available with a fixed disk (10 
million bytes or more), partitioning the disk for two or more operating 
systems divides the available space. Be certain that using more than 
one operating system is appropriate for your purposes. 


o You can partition the fixed disk for other operating systems later. In 
that case, you must perform several steps to copy existing files onto 
backup disks and partition and reformat the fixed disk before you can 
restore the backup files to the MS-DOS partition. 


o To set up other operating systems on your fixed-disk drive, refer to 
the appropriate documentation for the other systems. 


Follow these steps to create the MS-DOS partition: 
1. Start up the computer with a working copy of MS-DOS in Drive A. 


2. At the A> prompt, type: fdisk and press RETURN. 
The FDISK Options Menu appears on the screen. 


3. Press RETURN to choose option 1, Create DOS Partition. You see the 
message: 


Create DOS Partition 


Do you wish to use the entire fixed 
disk Tor DOS LXI su aceti die qd teca rd Eat ad rd cd wc [Y] 


Press Esc to return to FDISK Options 

4. Type: n and press RETURN. You see the message: 
Total fixed disk space is 611 cylinders 
Maximum available space is 611 


cylinders at cylinder O 


Enter partition size 


This message describes the total number of cylinders on your fixed disk 
and the size and location of the contiguous cylinders. If the fixed 


disk is larger than 10 megabytes, there will be more than 611 cylinders 
available. 


5. Type the number of cylinders you want to allocate for MS-DOS and press 


RETURN. The default is the largest available space on the fixed disk. 
You then see: 


Enter starting cylinder number..: [ 0] 


2-4 Using a Fixed Disk 


The default value displayed is the first cylinder of the space closest 
to the size required for the partition size you entered above. 


6. Press RETURN to accept the default value displayed. 


Or 


Type a number for the starting cylinder you want and then press RETURN. 
Note: If the first sector you've chosen for the partition is 
defective, MS-DOS starts the partition at the first good sector it 
finds. This may affect the size of the partition. 
7. Press ESC to return to the FDISK Options Menu. 
You now have a partition for MS-DOS. For information on how to format the 


partition, see below, Formatting the MS-DOS Partition 


Changing the Active Partition 


You can use as many as four partitions on a fixed disk. Only one 
partition, however, can be active at any given time. You can change the 
active partition, but it won't go into effect until you reset the system. 
Follow these steps to change the active partition: 


1. From the A» prompt, type: fdisk and press RETURN. 
The FDISK Options Menu appears on the screen. 


2. Type: 2 and press RETURN to choose Option 2, Change Active Partition. 
You see: 


Change Active Partition 

Partition Status Type Start End Size 
1 A DOS 0 3710 311 
2 N non-DOS 311 610 300 


Total disk space is 611 cylinders 


Enter the number of the partition you wan 
to make ACE DVEL C as uie aupra esit ue aC aedi cca ir ee 


Make sure you know which operating system you want to activate. 


3. Type the number of the partition containing the operating system you 
want to use. 
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4. Press RETURN. 


The operating system in the new partition is used the next time you 
start the computer. 


Displaying the Partition Map 


To see how the fixed disk is partitioned and to determine which partition 
is active, you can display the partition map. 


To display the partition map: 


1. From the A» prompt, type: fdisk and press RETURN. 
The FDISK Options Menu appears on the screen. 


2. Type: 4 and press RETURN to choose Option 4, Display Partition Data. 
The partition map appears on the screen. For example: 


Display Partition Information 
Partition Status Type Start End Size 


1 A DOS O 310 311 
2 N non-DOS 311 610 300 


Total disk space is 611 cylinders 
The current active partition is 1 


Press Esc to return to FDISK Options 


3. Press ESC to return to the FDISK Options Menu. 
Deleting the MS-DOS Partition 


WARNING 


Be careful. Deleting a partition destroys its contents. If you have any 
data on the fixed disk, use the BACKUP command to make backup copies of 


your files before you delete the MS-DOS partition. For more information on 
BACKUP, see Chapter 5. 


To delete the MS-DOS partition: 


1. From the A> prompt, type: fdisk and press RETURN. 
The FDISK Options Menu appears on the screen. 
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2. Type: 


You see: 


3. To cancel the delete operation, press ESC. 


Delete DOS Partition 


Partition Status Type Start 
1 A DOS O 
2 N non-DOS 311 


Total disk space is 611 cylinders 
The current active partition is 1 


Warning! Data in the DOS partition 


could be lost. Do you wish to 


GOTT UB, 6 oe oc s ETE 


To delete the MS-DOS partition, type: 


3 and press RETURN to choose Option 3, Delete DOS Partition. 


Size 
311 
300 


y and press RETURN. 


At this point you can either select another active partition and restart 
the computer, or use an MS-DOS disk in Drive A to restart the computer. 


FORMATTING THE MS-DOS PARTITION 


Whether your MS-DOS partition takes up the entire fixed disk or only a part of 
it, you need to format the MS-DOS partition before you can use it. 


Use the FORMAT command to build the MS-DOS directory, move the hidden system 
files into the partition (with the /S option), and give the partition a volume 
label (with the /V option). 


WARNING 


Formatting destroys all data on the partition. 


Before you proceed, make sure 


that the partition is empty or that all files have been backed up. 


Using a Fixed Disk /2-7 


To format the MS-DOS partition: 
1. Make sure an MS-DOS disk is in Drive A. 


2. At the A» prompt, type: format c:/v/s and press RETURN. 
You see the message: 


III WARNING!!! 
You are formatting the hard disk 
THIS WILL DESTROY ALL DATA ON THE HARD DISK 


Enter Y to continue, any other key 
will cancel the request to format. 


Do you wish to format the hard disk? 


3. To continue, type: y 
You see: 


WARNING, ALL DATA ON NON-REMOVABLE DISK 
DRIVE C: WILL BE LOST! 
Proceed with FORMAT (Y/N)? 


4. Again, type: y and press RETURN. 
Formatting a disk takes several minutes. When the process is complete, you 
see the message: 


Formatting...Format complete 
System transferred 


Volume label (11 characters, ENTER for none)? 

S. Type the volume label you want to give the fixed disk and press RETURN. 
(If you don't want to label the disk at this time, just press RETURN.) For 
more information on the LABEL command, see Chapter 5. 

6. Information is displayed on disk space, bytes used by the system, and bytes 
available on the disk. This information is followed by the MS-DOS prompt. 


Caution 


If the MS-DOS partition exceeds 10 megabytes and you format it with Version 
3.10, you won't be able to use previous versions of MS-DOS to operate the fixed 
disk. 


Once the MS-DOS partition is formatted, you make a working copy of MS-DOS. See 
below, Making a Working Copy of MS-DOS. 
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MAKING A WORKING COPY OF MS-DOS 


You need to make a working copy of MS-DOS for everyday use. Store the Master 
disk in a safe place. Then, if the working copy becomes damaged, you'll have 
the original MS-DOS Master disk to recopy. 


The procedure for making a working copy of MS-DOS on a fixed-disk system is 
described in Chapter 8 of the MS-DOS User's Guide. General information about 
the procedure is given below. 


Using SELECT 


The MS-DOS User's Guide instructs you to use the SELECT command to make a 
working copy of MS-DOS. The SELECT command allows you to choose the 
keyboard driver and the date, time, decimal, and currency formats that you 
want. The keyboard code represents the keyboard driver you choose. The 
country code represents the date, time, decimal, and currency formats you 
choose. When you type SELECT along with keyboard and country codes, MS-DOS 
creates a working copy that includes: 


o A CONFIG.SYS file that contains the country code. 
o An AUTOEXEC.BAT file that contains the keyboard code. 
For more information on the CONFIG.SYS file, see Chapter 7. For more 


information on the AUTOEXEC.BAT file, see Chapter 6. 


Installing the Clock Driver 


The Model D computer comes with a time-of-day clock and battery backup. 
You have the option of deciding whether or not you want to activate it. 

The time-of-day clock is activated by the CONFIG.SYS file stored on the 
MS-DOS Master disk. If you use the TYPE command to display the contents of 
this CONFIG.SYS file, you see: 


DEV I CE=CLKDVR . SYS 


CLKDVR.SYS is the clock driver. The MS-DOS User's Guide assumes that most 
people will want to use this CONFIG.SYS file to install the clock driver. 
One of the last steps in making a working copy of MS-DOS asks you to type: 


COPY A:CONFIG.SYS + B:CONFIG.SYS 
This command takes the CONFIG.SYS file on the MS-DOS Master disk and 
attaches it to the CONFIG.SYS file created by the SELECT command. The 
resulting CONFIG.SYS file is stored on the working copy. 


Note: The CONFIG.SYS file on the MS-DOS Master disk remains in its 
original form. 
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You may not want to install the clock driver if, for example, you are using 
the Model D on a network. If you don't want to install the clock driver, 
you should omit this step. 
For more information on the clock driver, see Chapter 7, DEVICE. 
Once you have a working copy of MS-DOS, you copy the files on it to the 
MS-DOS partition on the fixed disk. See below, Copying the MS-DOS Files. 
COPYING THE MS-DOS FILES 
Once the MS-DOS partition is formatted, use the COPY command to copy the MS-DOS 
external commands and related programs on it. You should first make a working 
copy of MS-DOS (see Chapter 8 of the MS-DOS User's Guide). 
To copy the MS-DOS files: 
1. Make sure a working copy of MS-DOS is in Drive A. 
2. At the A> prompt, type: copy a:*.* c:/v and press RETURN. 
3. The MS-DOS partition is now ready for you to use. 


To boot the fixed-disk system you can follow one of two procedures: 


o To boot the system using the operating system in the active partition on 
Drive C, leave the door to Drive A open. 


o To boot the system from Drive A with MS-DOS, put a working copy of MS-DOS 
in Drive A and close the door. 
UPDATING A PREVIOUS VERSION OF MS-DOS 


If you have a previous version of MS-DOS installed on your Model D fixed-disk 
system, you can easily replace it with Version 3.10. 


To replace a previous version of MS-DOS: 
1. Make sure a working copy of MS-DOS is in Drive A. 
2. At the A> prompt, type: sys c: and press RETURN. 
This copies the hidden system files to the fixed disk. The hidden system 


files from a previous version of MS-DOS are overwritten. 


3. Type: copy a:*.* c:/v and press RETURN. 
This copies the MS-DOS external files to the fixed disk. 


Note: Step 3 above assumes that you keep the MS-DOS external files in the root 
directory of your fixed disk. 
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.COM Files and Older Versions of MS-DOS 


COPY *.* replaces old MS-DOS files with new MS-DOS files only when their 
filenames are the same. The filename and extension of the source file must 
match the filename and extension of the target file. 


The filenames of the MS-DOS 3.10 external files are the same as the 
filenames in previous versions. However, in some cases, the filename 
extensions are different. For example, the CHKDSK command is stored in 
MS-DOS 3.10 as CHKDSK.EXE. In previous versions of MS-DOS, it is stored as 
CHKDSK.COM. 


Because COPY *.* replaces files only when their names match exactly, 
CHKDSK.EXE (from Version 3.10) will not replace CHKDSK.COM. Instead, after 
you copy the MS-DOS 3.10 files, there will be two CHKDSK files residing on 
your fixed disk. 


This can create a problem. When you execute an MS-DOS external command, 
MS-DOS looks for the file with that name. If it finds two files with the 
same filename (but different extensions), MS-DOS has to decide which file 

to use. MS-DOS is set up to choose .COM files first when two or more files 
with the same filename exist on a disk. In this case, the .COM files are 
the older versions. 


To avoid this, use the DIR command to inspect the list of MS-DOS external 
commands on your fixed disk. If there are any duplications, delete the 
older version of the file (the one with a .COM extension). 


SUMMARY 


A partition reserves space on a fixed disk for an operating system to use. You 
can have up to four partitions on a Leading Edge Model D fixed-disk system. 


There are three steps to installing MS-DOS on the fixed disk: 


O 


Use the FDISK command to create a partition for MS-DOS. 

Use the FORMAT command to format the MS-DOS partition. 

Use the COPY command to copy the external MS-DOS files to the partition. 
FDISK command handles all aspects of partitioning a fixed disk: 

Creating the MS-DOS partition. 

Changing the active partition. 

Displaying the partition map. 


Deleting the MS-DOS partition. 
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FDISK allows you to create and delete the MS-DOS partition without affecting 
partitions defined for other operating systems on the same disk. Partitions 
for use by another operating system are created, changed, or deleted by using 
that operating system's fixed-disk preparation program. 


Once the MS-DOS partition is ready, you can organize it in any way you like 
using a multilevel directory structure. Chapter 3 describes this structure and 
the commands you use to work with it. 


If you have already installed a previous version of MS-DOS on the fixed disk, 
you can use the SYS and COPY commands to replace it with Version 3.10. 
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ORGANIZING A FIXED DISK 
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ABOUT DIRECTORIES AND SUBDIRECTORIES 


Because the capacity of a fixed disk is so much greater than that of a floppy 
disk, it is to your advantage to set up an orderly system for storing and 
accessing files. 


Using MS-DOS, you can group your files in directories and subdirectories, 
dividing them up according to content and/or to particular users. The result 
is a multilevel structure that resembles an upside-down tree, starting with the 
root at the top and branching downward into successive directory levels, as 
shown in Figure 3-1 below. 


ROOT 
PERSONL MEMOS CAMERON 
program program files 
PAYROLL 
SCHWARTZ 
diae files 


and files 





SCHWARTZ 
files 


Figure 3-1 Example of a Multilevel Directory Structure 


Figure 3-1 shows a directory structure designed for a personnel office. The 
first and highest level is the NROOT directory. Under the NROOT are four main 
subdirectories: 

(e \DOS, a subdirectory for most of the operating system commands. 

[o \PERSONL, a database subdirectory for personnel records. 

o \MEMOS, a subdirectory for a word processing program. 


(e \CAMERON, the manager's personal subdirectory. 


\PERSONL has its own subdirectory called \PAYROLL that holds a spreadsheet 
program. 
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Finally, \PAYROLL and \MEMOS both have subdirectories created for an assistant, 
Schwartz, to hold his word processing and spreadsheet files. 


Terms and Definitions 


Certain directory terms help illustrate the way a multilevel directory 
structure works. 


Root Directory. When MS-DOS formats the fixed disk, it sets up an initial 
directory called the root directory. 


Directory Entries. Directory entries can be files, subdirectories (for 
grouping files), or a volume label (a name the user assigns to a disk). 
The root is the only directory with a limited capacity; it can hold a 
maximum of 255 entries. Subdirectories can hold as many files and 
subdirectories as disk space allows. 


Displaying Contents of a Directory. Use the DIR (Show Directory) command 
to display the contents of a directory. For example, to see the contents 
of the NPAYROLL subdirectory in Figure 3-1, you type: 

DIR \PERSONL\PAYROLL 


You then see the following: 


Volume in drive C has no label 
Directory of C: \PERSONL\PAYROLL 


<DIR> 8-06-85 9:33p 
<DIR> 9-11-85 4:4/p 


ACCOUNT EXE 9-10-85 9:00p 
SALARY DOC 9-10-85 9:01p 
SCHWARTZ <DIR> 9-11-85 5:35p 


Current Directory. The directory you are in at a given time is the 
current directory, sometimes called the working directory. When you 
create a file, that file is automatically placed in the current directory, 
unless you specifically tell MS-DOS to put it elsewhere. 


Parent Directory. Any directory that has subdirectories underneath it is 
called a parent directory. In Figure 3-1, for example, \PERSONL is the 
parent directory of \PAYROLL, and \PAYROLL is the parent directory of 
\SCHWARTZ. 


In the directory listing above, the single dot (.) indicates the current 
directory, and the double dots (..) represent the parent directory. 
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Path. The path describes the location of a file or a subdirectory by 
listing, in descending sequence, the parent directories that lie above 

it. Subdirectories in the path are separated by a backslash character 
(\). For example, the path in Figure 3-1 to the \SCHWARTZ subdirectory 
is: 


\PERSONL \ PAYROLL \SCHWARTZ 


Files can be stored in any levels in the hierarchy. If you want to work 
with a file outside the current directory, you have to tell MS-DOS where 
it is by describing the path to it. 


If a path begins with a backslash character (\), MS-DOS searches for the 


file beginning at the root directory. Otherwise, MS-DOS starts at the 
current directory and searches downward from there. 


CREATING A MULTILEVEL DIRECTORY STRUCTURE 
Following is a discussion of some of the commands you can use to create a 
multilevel directory structure. 
Creating Subdirectories 
To create a subdirectory, use the MKDIR (Make Directory) command. The 
abbreviation MD is also valid when you issue the command. For example, 
let’s assume you have just booted the computer, and you are in the root 
directory. Type: 
MD PERSONL 


You now have a directory structure that looks like this: 
ROOT | 
PERSONL 


\PERSONL is a subdirectory of the \ROOT. 


A subdirectory name must not exceed 8 characters. Like filenames, 
subdirectory names can have three-letter extensions. In general, the same 
rules apply to naming directories as apply to naming files (see Chapter 

1). 
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Removing Subdirectories 
To delete a subdirectory in a multilevel structure, use the RMDIR (Remove 
Directory) command. The abbreviation RD is also valid when you issue the 
command. However, note that the RMDIR command does not execute unless the 
directory you want to delete is empty. This feature prevents you from 
accidentally erasing files and directories you want to keep. 


To empty a directory, use the DEL (Delete) command to delete files, and 
then use the RMDIR command to remove the directory. 


Note: The special entries . and .. remain in the subdirectory you want to 
delete. 
ACCESSING SUBDIRECTORIES AND FILES 


Two commands allow you to access files and subdirectories in a multilevel 
directory structure: (CHDIR and PATH. 


Changing Directories 
The CHDIR (Change Directory) command can be used in two ways: 
o To display the current directory, if you want to check your location. 
o To change from one directory to another. 
For a display of the current directory, type the command alone: 
CHDIR 


MS-DOS shows you where you are in the directory structure, as in this 
example: 


C: \PERSONL \ PAYROLL 
Otherwise, use the CHDIR command to move from one directory to another. 
The abbreviation CD is also valid when you issue the command. For 
example, suppose you are in the \PERSONL directory, and you want to move 
to \PAYROLL. You type: 


CD \PAYROLL 
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Using the PATH Command 


Normally, MS-DOS looks in the current directory for the commands and 
programs whose names you type, and if they are not there, it stops 
searching. 


The PATH command tells MS-DOS where to look for commands, programs, or 
batch files, if it cannot find them in the current directory. In effect, 

it gives MS-DOS an extended search route, so that your most frequently 
used files are always accessible. 


Using Figure 3-1 as an example, suppose that the manager, Cameron, wants 
access at all times to the accounting program file stored in \PAYROLL. 
She would set the path by typing: 


PATH C:\PERSONL\PAYROLL 


You can give MS-DOS more than one path to search, separating paths with a 
semicolon. For example, if Cameron wants access to both NPAYROLL and the 
word processing program in \MEMOS, she sets the path like this: 


PATH C:\PERSONL\PAYROLL;C:\MEMOS 


You can enter the PATH command in an AUTOEXEC.BAT file. From then on, 
whenever you start the system, the PATH command is set automatically. For 
more on batch files, see Chapter 6. 


Storing MS-DOS Commands in a Subdirectory 


MS-DOS has many command files. For the sake of organization, some users 
prefer to keep most of those files in a subdirectory, rather than in the 
root directory. However, this can lead to problems if you don't take 
certain precautions. 


Caution 


Any CONFIG.SYS file you create must be in the root directory. COMMAND.COM 
should also be in the root directory since it is required to start the 

computer. However, you have the option of putting COMMAND.COM in a 
subdirectory if you use a SHELL command in your CONFIG.SYS file. See 
Chapter 7 for more information. 


You can copy all other MS-DOS files into a subdirectory. If you do, then 
you should create an AUTOEXEC.BAT file in the root directory with a PATH 
command to indicate the location of the MS-DOS files. The PATH command 
should be the first entry in the AUTOEXEC.BAT file. 
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Displaying the Path in the Prompt 
To keep track of your location in the directory structure, you can change 
the MS-DOS prompt to reflect the current directory. To do this, use the 
PROMPT command. Type: 
PROMPT $p$g 


The $ serves as a prefacing symbol, the p stands for the current 
directory, and the g stands for the » character. 


Now, instead of the usual C» prompt, you will see a prompt that states 
your location in the directory structure, such as: 


C: \MEMOS \SCHWARTZ> 

This prompt tells you that you are in the \SCHWARTZ subdirectory. For 
more information on the PROMPT command, see Chapter 5. 

MS-DOS Commands for Fixed-Disk Users 
The commands below are described for your convenience. They are covered 
in detail in Chapter 5, which you should read before executing the 
commands. 
The BACKUP command is used to make backup copies from one disk to 
another. It is most commonly used to copy files from the fixed disk to 
floppy disks, to serve as backups in case of fixed-disk problems. 
File copies made with the BACKUP command are not usable until you restore 


them with the RESTORE command. 


WARNING 


Using BACKUP and RESTORE may damage copy-protected software. If you have 


installed copy-protected software on a fixed disk, you need to check the 
software documentation before you use BACKUP or RESTORE. 


The TREE command lets you look at a list of all paths and subdirectories 
on a specified drive. If you apply the /F option, TREE will list all the 
files in each subdirectory. 


The XTREE command tells MS-DOS to list all the subdirectories below the 
current directory. XTREE will also help you locate files. For instance, 
if you want to find a file called MYFILE.TXT, but you are not sure which 
directory it is in, type: 


XTREE MYFILE.TXT 


Organizing a Fixed Disk /3-7 


MS-DOS will find the file and tell its location in the directory 
structure. 


SUMMARY 
The large capacity of a fixed-disk system calls for a multilevel directory 
structure in which files can be logically grouped according to who uses them 


and what they contain. 


Several MS-DOS commands pertain specifically to multilevel directory 
structures: 


Command Purpose 

MKDIR (MD) Creates a directory within the current directory. 

RMDIR (RD) Removes a directory after you have erased everything in 
it. 

CHDIR (CD) Allows you to check your location or to change from one 
directory to another. | 

BACKUP Copies files from one disk to another. These backups 
can be restored only by using the RESTORE command. 

TREE Lists paths and directories on a specified drive. 

ATREE Lists directories on the current drive, beginning with 


the current directory and working downward. 


Table 3-1 Commands to Use with Directories 
It can be useful to keep text and data files in directories separate from 


programs. You can use the PATH command to tell MS-DOS where to search for the 
programs and commands you need, so that you can always have access to them. 
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CHAPTER 4 
INPUT AND OUTPUT 
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ABOUT INPUT AND OUTPUT 


Input is anything sent to the computer for processing. Some examples of input 
are: 


o Anything you type at the keyboard. 
o Information sent to the computer through a modem. 
o Information sent to the computer from a file. 


Unless you redirect it, MS-DOS always assumes that input comes from the 
keyboard, or standard input device. 


Output is anything the computer returns as a result of what it is currently 
processing. Some examples of output are: 


O The results of commands such as DIR, TYPE, and CHKDSK. 
o The results of computations. 
o Information sent from a file to a computer. 


Unless you redirect it, MS-DOS always assumes that output goes to the monitor 
screen, or standard output device. 


REDIRECTING INPUT AND OUTPUT 
Command input and output can be redirected. For example, input can come from a 
file rather than the keyboard; output can go to a file or to a printer instead 


of to the screen. Also, pipes can be created to allow output from one command 
to become input to another command. Redirection and pipes are discussed below. 


Redirecting Output 
Most commands produce output that is sent to the monitor screen. If you 
want to send output to a file or a printer, you can redirect the 


information with a greater-than sign (>) in your command. 


Printer. The syntax for redirecting output to a printer or other device is 
as follows: 


> device 


For a list of device names, see Chapter 1, Reserved Filenames. 
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The following example redirects the output of the DIR command to the 
printer: 


DIR >LPT1 


This translates as follows: 


DIR List the contents of the directory... 
> ...and send the output to... 
LPT1 .the printer. 


Refer to the CITY command for more information on changing the output 
device. 


Another File. The syntax for redirecting output to a file is: 
>[ d:][ path ] fi /ename [. ext ] 
Or 
»»[d:][ path ] £//ename [. ext ] 


The following example redirects the output of the DIR command to a file 
called OCT.LST: 


DIR »OCT.LST 


This translates as follows: 


DIR List the contents of the directory... 
» ...and send the output to... 
OCT.LST ..& file called OCT.LST. 


If the file OCT.LST doesn't exist, MS-DOS creates it and stores the 
directory listing in it. If OCT.LST already exists, MS-DOS overwrites what 
is in the file with the new data. To view the contents of OCT.LST, use the 
TYPE command. 


If you want to append the output of a command to an exising file, use two 
greater-than signs (>>). For example: 


DIR >>DOSDISK.DAT 
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This translates as: 


DIR List the contents of the directory... 
>> ..and append the output to... 
DOSDISK.DAT ...a file called DOSDISK.DAT. 


If the file DOSDISK.DAT doesn't exist, MS-DOS creates it. 


Caution 


Some commands generate screen messages as they run that require an answer 
from you. If output (including screen messages) is redirected, you won't 

see the messages, and thus can't answer. MS-DOS waits indefinitely for a 
response, so you will be hung up. 


For example, the CHKDSK command sometimes finds errors and displays an 
appropriate message, such as: 


Convert lost chains to files (Y/N)? 


If the output of CHKDSK is redirected to a file, you won't see the 
message. MS-DOS will pause to wait for a Y or N response. 


Redirecting Input 
To have input for a command come from a file rather than from an input 
device like a keyboard, use a less-than sign («) in your command. The 
syntax for redirecting input to a file is as follows: 
<[ d :][ path ] fi /ename [. ext ] 
The following example provides input to the SORT command from a file: 


SORT «LIST.DAT 


This translates as follows: 


SORT Sort the data... 
< ..coming from... 
LIST.DAT ..a file called LIST.DAT. 
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You may be able to run an application program using input from a file. 
There are two things, however, that you need to consider: 


o Make sure the input file contains all the information the application 
program needs. (If the program looks for information after the end-of- 
file mark, MS-DOS stops.) 

o Redirection doesn't work unless the application program uses MS-DOS 
system calls. 

Command Piping 

If you want the output of one program sent as input to another program, use 

the pipe symbol (), which is a broken vertical bar. The bar causes all 

output generated by a command on the left side of the bar to be sent to the 


right side of the bar for processing. 


The following example displays an alphabetically sorted listing of the 
directory: 


DIR ; SORT 
This translates as follows: 
DIR List the contents of the directory... 


i ..in a temporary file. Use the temporary file as input 
LOS. 


SORT ..the SORT program. 


You can string several programs together with the pipe symbol. For 
example: 


DIR : SORT : MORE 
This converts the output of DIR to input for the SORT command. The output 
of SORT is then converted to input for the MORE command. 
Filters 
A filter is a command that reads input, transforms it in some way, and then 


Outputs it, usually to the screen or to a file. Thus, data is said to have 
been filtered by the command. 
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The MS-DOS commands that act as filters are FIND, MORE, and SORT. Their 
functions are described below. 


FIND Searches for a string of text in a file. 
MORE Displays text one screen at a time. 
SORT Sorts text. 


For more information on these commands, see Chapter 5. 


SUMMARY 


The standard input device in MS-DOS is the keyboard. The standard output 
device is the monitor screen. You can tell MS-DOS to accept input from or send 
output to another device or file. 


Filter commands can be used to transform input, and piping can be used to make 
output from one source into input for another. 
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CHAPTER 5 
MS-DOS COMMANDS 
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ABOUT THIS CHAPTER 


This chapter describes MS-DOS commands and the rules and guidelines that 
pertain to them. Chapter 6 describes batch file commands. 


Before you begin you need to read the sections below, Information About 
Commands and Command Syntax, so that you are familiar with the conventions used 
in this manual to describe MS-DOS commands. 


INFORMATION ABOUT COMMANDS 


Commands are presented in alphabetical order. For each command you'll see: 


O Purpose -- explains what a command does and what it’s used for. 

O Syntax -- presents the format in which you type a command. 

o Type -- tells you whether a command is internal or external. 

O Comments -- explains certain aspects of syntax and give you a general 


overview of the command. 


o Options -- lists all optional switches that control a command. 

o Examples -- provides sample commands in proper syntax. 

O Reference -- tells you where to find more information and lists related 
commands. 


Command Syntax 


MS-DOS commands must be entered according to the rules called command 
syntax. You must follow syntax exactly to initiate the correct action. 
You should keep the following points in mind: 


o Commands can appear in any combination of upper- or lowercase, but be 
careful to spell them correctly. 


O Italics are used in this manual to indicate that you should make a 
substitution. For example, you should type the name of your file when 
filename is shown in the command syntax. 


o Items in square brackets [] are optional. If you want to include 
optional information, type the the information within the brackets, not 
the brackets. 


o An ellipsis (...) means that you can repeat an item as many times as 
needed. 


o All punctuation such as commas, equal signs, question marks, colons, or 


slashes must be included. Don’t enter square brackets, ellipses, or 
vertical bars. 
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O A solid vertical bar (I) indicates a choice between two or more 
entries. At least one of the entries must be chosen unless the entries 
are optional. (If they're optional, they're enclosed in square 
brackets.) For example: 

ON|OFF 
You should type either ON or OFF. Don’t type the vertical bar. 


You'll see the following variables used in command syntax: 


Variable Meaning Example 

d: Disk drive. You type in the A: 
letter name of the appropriate drive. 

filename Any valid name for a disk file. LEITER1 

.ext An optional filename extension TXT 


consisting of a period and 1 to 3 
characters immediately following a 
filename. 


path The path to follow in a directory \ACCOUNI\PAY \ 
structure. (Information on using a 
path is given in Chapter 3.) 


string A group of characters including mud 
letters, numbers, spaces, and symbols. 
(Searching for a particular word in a 
file is a common use of a string.) 

device A system device such as a printer. LPT 1 


(For more information on devices, 
see Chapter 1, Reserved Filenames.) 


Table 5-1 MS-DOS Command Syntax -- Variables 
In addition, you need to be aware of the following definitions: 
complete file specification 


Refers to a drive name, a filename, and a filename extension. For 
example: B:MYPROG.EXE 
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complete path specification 


Refers to a drive name, a path, a filename, and a filename extension. 
For example: C:\FRED\LETTERS\MEMOMSTR . DOC 


Some things to keep in mind when you type a command: 
o Commands are usually followed by one or more parameters. For example: 
RENAME LETTER1.TXT ACME.TXT 


RENAME is a command, LETTER1.TXT is a parameter, and ACME.TXT is 
another parameter. 


o Commands and parameters must be separated by: 

a Space 

a comma 

a semicolon 

an equal sign 

Or 

the TAB key. 

For example, the following commands are equivalent: 
RENAME LETTER1.TXT ACME.TXT 
RENAME,LETTERT1.TXT, ACME. TXT 
RENAME ;LETTER1. TXT=ACME . TXT 


For ease of reading, this manual uses spaces to separate commands and 
parameters. 


o There are no spaces between the parts of a complete file 
specification. For example: A:JOB.EXE 


o There are no spaces between the parts of a complete path 
specification. For example: C:\LEWP\DIARY\JANS3. TXT 
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o Unlike previous versions of MS-DOS, MS-DOS 3.10 allows you to specify a 
path to a specific command or program that you want to execute. Let's 
say you moved the EDLIN program to a directory named \EDIT. The 
command: 


\EDIT\EDLIN NEWF ILE. TXT 


tells MS-DOS to look in the NEDIT directory for the EDLIN program. 
EDLIN runs and either creates or edits NEWFILE.TXT in the current 
directory. 


USING MS-DOS ON A NEIWORK 


Some of the MS-DOS commands don't work over a computer network. These commands 
do not work over a network: 


CHKDSK 

DISKCOMP (Use COMP to compare files.) 
DISKCOPY (Use COPY to copy files.) 
FDISK 

FORMAT 

RECOVER 

SYS 


If you try to use these commands, MS-DOS displays this message: 
Cannot command to a network device 

where command is the name of the command you typed. 

The following commands work, with certain limitations: 
JOIN (You can't JOIN a network drive to a local drive.) 
LABEL (You can't change the label on a network disk.) 
PRINT (You can't use PRINT on a network server computer.) 


SUBST (You can't SUBST a drive letter for a network path.) 


Look up individual commands for more information on how they work on a network. 


TABLE OF MS-DOS COMMANDS 


A list of all the MS-DOS commands follows. Alternative spellings for commands 
are in parentheses. 


ASS IGN Assigns a drive name to another drive. 
ATTRIB Changes and displays the read-only attribute for a file. 
BACKUP Backs up files from one disk to another. 
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BREAK 


CHDIR (CD) 


CHKDSK 


CHMOD 


CLS 


COMP 

COPY 

CITY 

DATE 

DEL (ERASE) 
DIR 
DISKCOMP 
DISKCOPY 
ERASE (DEL) 
EXE2BIN 


EXIT 


FDISK 


FIND 
FORMAT 
GRAF TABL 


GRAPHICS 


Sets a check for CTRL BREAK or CTRL C. 


Changes directories; displays the name of the working 
directory. 


Scans the directory and File Allocation Table of the disk 
in the default or designated drive and issues a status 
report. 

Changes or displays file and directory attributes. 
Clears the screen. 

Tells the computer you're using a color monitor. 
Loads a secondary command processor. 

Compares the contents of two or more files. 

Copies files. 

Changes the standard input and output device. 
Displays or sets the date. 

Deletes files. 

Lists requested directory entries. 

Compares the contents of two floppy disks. 

Copies floppy disks. 

Deletes files. 

Converts executable files to binary format. 


Exits the secondary command processor and returns to the 
previous level. 


Creates, displays, changes, and deletes fixed-disk 
partitions. 


Searches for a string of text in a file. 
Prepares a disk to receive MS-DOS files. 
Loads a table of graphics characters. 


Allows graphics on the screen to be printed on a graphics 
printer. 
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JOIN Connects a drive to a directory on another drive. 


KEYBxx Loads international keyboard drivers. 

LABEL Gives a disk a volume label. 

MKDIR (MD) Makes a directory. 

MODE Sets display, communications, and printer environments. 
MONO Tells the computer you're using a monochrome monitor. 
MORE Displays output one screen at a time. 

PATH Sets a search path in a multilevel directory structure. 

PRINT Prints in background mode. 

PROMPT Designates command prompt. 

RECOVER Recovers a bad disk or file. 

REN (RENAME) Renames a file. 

RESTORE Restores files created by BACKUP. 

RMDIR (RD) Removes a directory. 

SELECT Selects keyboard and country codes. 

SET Sets one string value to another in the environment, or 


displays the environment. 


SHARE Installs file sharing and locking. 

SIZE Displays file sizes. 

SORT Sorts data in ascending or descending order. 

SUBST Uses a drive name to refer to another drive or path. 

SYS Transfers the MS-DOS system files to the disk in the 
specified drive. 

TIME Displays or sets the time. 

TREE Displays directories and their contents. 

TYPE Displays the contents of a file. 
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VDISK 
VER 
VERIFY 
VOL 
XASS | GN 


XTREE 


Creates a virtual disk drive in RAM. 
Displays the MS-DOS version number. 
Verifies all writes to disk. 

Displays the volume label. 

Permits path assignments from programs. 


Extends the TREE command. 


Batch Processing Commands (see Chapter 6): 


ECHO 
FOR 
GOTO 


IF 


PAUSE 
REM 


SHIFT 


On/Off command for displaying the lines in a batch file. 
Allows for the repeated execution of MS-DOS commands. 
Directs a jump to a specified location. 


Used in batch files to test for four different types of 
conditions. 


Waits for user action. 
Allows comments in a batch file. 


Increases the number of replaceable parameters. 
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ASSIGN 


Purpose 


The ASSIGN command instructs MS-DOS to redirect all requests for one drive 
to a different drive. 


Syntax 


ASSIGN [ x=y [...]] 


Type 
External 


As with all external commands, you can precede ASSIGN with the drive and 
path on which it is located. For example: A>C:\DOS\ASSIGN 


Comments 


Some application programs are designed to use only specific drives, such as 
Drives A and B. You can use the ASSIGN command to run these applications 
on a different drive, such as a fixed-disk drive. ASSIGN x=y redirects all 
requests for the drive specified as x to the drive specified as y. 


x is the drive which MS-DOS currently reads from and writes to. y is the 
drive you want MS-DOS to read from and write to. For example, ASSIGN A=C 
redirects all references to Drive A to Drive C. Both x and y must exist as 

a disk drive, a fixed-disk drive, or a virtual drive created using the 

VDISK command. 


Enter only the drive letters. Do not type the colons normally included in 
a drive name. Note that the equal sign is optional. 


The ellipsis (...) indicates that you can specify more than one x=y 
parameter. See Examples below. 


Typing ASSIGN by itself resets the drive assignments to the default values 
(A=A, B=B, and so on). 


Note: Reassign drives only when necessary. Reassigning drives while using 


MS-DOS for normal operations can hide actual drive information (such as 
device type) from commands and programs that require it. 
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The DISKCOPY and DISKCOMP commands ignore drive assignments. The ASSIGN 
command should never be used with the BACKUP, FORMAT, LABEL, JOIN, RESTORE, 
SUBST, or PRINT commands. 

Examples 
C>ASSIGN A=C 


Routes all requests for Drive A to Drive C. Thus, if you type DIR A: 
the directory for Drive C is displayed. 


C>ASSIGN A=C B=D 


Routes all requests for Drive A to Drive C and all requests for Drive B 
to Drive D (a virtual drive created using the VDISK command). 


C>ASSIGN 
Resets all drive assignments to their default values. Requests for 
Drive A go to Drive A, requests for Drive B go to Drive B, and so on. 
Reference 
In this chapter, you should also read about these commands: 


SUBST 
XASSIGN 
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ATTRIB (Attribute) 


Purpose 


The ATTRIB command lets you check and alter the read-write status of a 
file. 


Syntax 


ATTRIB [+R|-R] [d: ][ path] £//ename [. ext ] 


Type 
External 


As with all external commands, you can precede ATTRIB with the drive and 
path on which it is located. For example: A>C:\DOS\ATTRIB *.* 


Comments 


You can use the ATTRIB command to set the read-only attribute to a file, to 
remove the read-only attribute, or to find out whether a file has already 
been set to read-only. 


To set the read-only attribute to a file, type ATTRIB +R followed by the 
filename of the file you want to have read-only status. To remove the 
read-only attribute, type ATTRIB -R followed by the filename. You can 
precede filename with a drive and a path. Otherwise MS-DOS looks for the 
file on the default drive in the current directory. 


If you type ATTRIB and a filename, MS-DOS tells you whether that file is 
read-only. 


You can use wildcard characters (* and ?) with ATTRIB. 
If an application opens a file with read and write status, ATTRIB forces 
read-only mode to allow file sharing over a network. 
Examples 
A>ATTRIB B:RELEASE. 223 


Displays the current status of the file called RELEASE.223 on the disk 
in Drive B. For example: 


R B: \RELEASE . 223 
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The R indicates that the status of the file is read-only. If you tried 
to edit this file, you would get a File is READ-ONLY message. 


A»ATTRIB -R B:RELEASE.223 
Removes the read-only attribute for the RELEASE.223 file on Drive B. 
You can write to the file once the read-only attribute is removed. 
Reference 
In this chapter, you should also read about the following command: 


CHMOD 
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BACKUP 


Purpose 


The BACKUP command makes backup copies from one disk to another. 


Syntax 


BACKUP d: [ path ][ £//ename [. ext ]] d: US JVM ]U/A ][/D : date ] 


Type 
External 


As with all external commands, you can precede BACKUP with the drive and 
path on which it is located. For example: A>C:\DOS\BACKUP C: A: 
Comments 


Use the BACKUP command to back up files from a fixed disk to floppy disks. 
You can also back up files from: 


o A fixed disk to another fixed disk. 
o A floppy disk to a fixed disk. 


o A floppy disk to another floppy disk. 


WARNING 

It's possible to damage copy-protected software with BACKUP. If you have 
installed copy-protected software on a fixed disk, you need to check the 
software documentation before you use BACKUP. 


The first set of parameters are the source parameters. You can specify: 


O The source drive. The source drive is the location of the files that 
you want to back up. You must always enter the source drive. 


o A path, if you want to back up only a particular directory. 


o A filename and an extension, if you want to back up a particular file. 
You can use wildcards (* and ?) with BACKUP. 


You can use the /S option to include all the files in all the 
subdirectories of the source. See Options below. 
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You must specify the target drive. The target drive is the destination of 
the files that you're backing up. The target drive must be different from 
the source drive. If the target drive is a fixed-disk drive, MS-DOS 
creates a subdirectory called NBACKUP for the backup files. 


BACKUP is not the same as COPY. Files duplicated with the BACKUP command 
can't be used until you've restored them with the RESTORE command. Backup 
files created with the COPY command can be used any time. 


If you're backing up files onto floppy disks, you need formatted floppy 
disks. The RESTORE command will prompt you for disks by their number. 
Number the floppy disks as you go. Files have to be restored in the order 
that they were backed up. 


Note: You'll need approximately 29 floppy disks to back up every 10 
megabytes of storage on a fixed disk. 


Unless you specify the /A option, copies of any old files on a backup 
floppy disk are erased before the new files are written on it. See Options 
below. 


The BACKUP command sets exit codes as follows: 


O The BACKUP program completed normally. 

1 No files were found to back up. 

2 | Some of the files were not backed up because of file sharing 
conflicts. 

3 CTRL BREAK or CTRL C stopped the BACKUP program. 

4 An error stopped the BACKUP program. 


Exit codes can be used in a batch file with the IF command. See Chapter 6. 


On a network you can back up only files that you have access to. Don’t use 
BACKUP on assigned, substituted, or joined drives. 


Options 

/S Backs up all files in all subdirectories in the specified 
or current directory. 

/M Backs up only those files that have changed since you 
executed the last backup. 

/ A Adds the files being backed up to those already on the 
backup disk and does not erase old files on the disk. 

/D:date Backs up only those files that were last modified on or 


after a certain date. date should be in the format that 
you see when you load MS-DOS. 
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Examples 
C>BACKUP C: A:/S 


Backs up all the files in all the subdirectories on Drive C and puts 
them on disks in Drive A. 


C>BACKUP DING.BAT A:/A 


Backs up one file, DING.BAT, from Drive C and puts it on the disk in 
Drive A. No files on Drive A are erased. 


A»BACKUP C: A:/D:2-7-85 


Backs up files in the current directory on Drive C that have been 
modified on or after Feb. 7, 1985 and puts them on the disk in Drive A. 


C>BACKUP C:\MSDOS\BATCH A: 
Backs up files in the \MSDOS\BATCH subdirectory and puts them on the 
disk in Drive A. 
Reference 
In this chapter, you should also read about the following command: 
RESTORE 
In addition, you'll find related information in the following chapter: 


Chapter 6, IF 
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BREAK 


Purpose 
The BREAK command sets the extended CTRL BREAK check to either ON or OFF. 


Syntax 


BREAK [ ON|OFF ] 


Type 


Internal 


Comments 
Normally, when a program requests MS-DOS to perform any input or output 
(I/O) operation, MS-DOS checks to see whether CTRL BREAK or CTRL C have 
been pressed. 


If BREAK is OFF (the default setting), MS-DOS only checks for CTRL BREAK or 
CTRL C during these input and output operations: 


o Standard input (keyboard) operations. 

o Standard output (monitor) operations. 

o Standard print device operations. 

o Standard auxiliary device operations. 

If BREAK is ON, MS-DOS checks for CTRL BREAK or CTRL C with every MS-DOS 
operation. This extends checking to other operations like reading and 

writing to a disk. Programs like compilers, which perform little or no 

device input or output, may require the BREAK ON setting to extend CTRL 
BREAK checking to all MS-DOS operations. 

If you type BREAK by itself, MS-DOS displays the current setting of BREAK. 


Note: You can also set the BREAK command by entering it in a CONFIG.SYS 
file. See Chapter 7 for details. 
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Examples 
A»BREAK ON 


Sets the extended CTRL BREAK check to ON. 


A»BREAK 
Displays the current setting of BREAK after you press RETURN. For 
example: 
BREAK is on 
Reference 


You'll find related information in the following chapter: 


Chapter 7, BREAK 
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CHDIR or CD (Change Directory) 


Purpose 
The CHDIR command can be used to: 
o Change the current directory of the specified or default drive. 


O Display the name of the current directory. 


Syntax 
CHDIR [d: ][ path] 
or 


CD [d: ][ path] 


Type 


Internal 


Comments 


When you're storing files in a multilevel directory structure, you need the 
CHDIR command to change directories. It allows you to move around within 
the structure. CD can be used as an abbreviation for CHDIR. 


The CHDIR command by itself tells you where you are within a directory 
structure. Type CHDIR or CD to display the current directory. 


CHDIR can be followed by: 


o A backslash character (X by itself, when you want to return to the 
root directory. 


o Two periods (..), when you want to go to the parent directory of the 
current directory. 


o <A drive, when you want to indicate a drive other than the default. 
o A path, when you want to indicate the directory you want to go to. 


Whenever the backslash character leads a list of directory names it tells 
MS-DOS to start looking from the root directory. Start with the backslash 
character when you want to move upwards in a directory structure. Leave 
out the leading backslash character when you want to move downwards from 
the current directory. The backslash character is also used to separate 
directory names. 
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Note: You can set the MS-DOS prompt so that it always tells you the 
of the current directory. See the PROMPT command. 


Examples 
C>CD 


Displays the name of the current directory. 


CICD X 


Returns you to the root directory. 


CCD .. 


Puts you in the parent directory of the current directory. 


The following examples are based on the multilevel directory structure 
pictured below. 


ce] Der 
Sues] [mer] [wx] [mes] [Pav] [Recene 
IPRINTS| | PHOTOS 


Figure 5-1 Example of a Multilevel Directory Structure 


C»CD \DOS 


name 


From wherever you are in the structure, this command puts you in the 


\DOS directory. The leading backslash tells MS-DOS to start looking 


from the root directory. If you’re in the root directory, you simply 
type: 


CD DOS 
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C>CD BABS 
When you’re in the \EMPLOY directory, this command moves you down to 
the \BABS subdirectory. If you’re not currently in \EMPLOY, you get an 
Invalid directory message. 

C>CD \EMPLOY\BABS 
From wherever you are in the structure, this command moves you to the 
\BABS subdirectory. The leading backslash tells MS-DOS to start 
looking from the root directory. 


Reference 


In this chapter, you should also read about these commands: 


In addition, you'll find related information in the following chapter: 


Chapter 3 
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CHKDSK (Check Disk) 


Purpose 
The CHKDSK command scans the directories and File Allocation Table of the 
disk in the specified or the default drive and issues a status report. 

Syntax 


CHKDSK [d: ][ path ][ fi /ename [. ext ]UF ][/V ] 


Type 
External 
As with all external commands, you can precede CHKDSK with the drive and 
path on which it is located. For example: A»C: DOS VCHKDSK 

Comments 


You can run CHKDSK on a disk, a directory, or a file. CHKDSK displays a 
status report that contains information on: 


o Total disk and memory space. 

Oo Space used by any hidden files. 

Oo Space used by any directories. 

O Space used by any user files. 

o Available space on disk and in memory. 

If you specify a filename, CHKDSK displays the number of non-contiguous 
areas, if any, occupied by that file. Since a file runs more slowly when 
its non-contiguous, you may want to consolidate it (see below). You can 
use wildcards (* and ?) with CHKDSK. 

Note: Make a copy of a disk that has non-contiguous files with the COPY 
*.* command. COPY *.* copies whole files and stores them in contiguous 
blocks on the destination disk. This may improve the efficiency of the 
files stored on it. 

The drive and path tell MS-DOS where to find the filename you want to 


check. If they're not specified, MS-DOS looks on the default drive in the 
current directory. 
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It's a good idea to use CHKDSK from time to time to check for errors in the 
directory and File Allocation Table on a disk. If errors are found, CHKDSK 
displays error messages (see Appendix B). If CHKDSK finds errors, some of 
them can be fixed if you specified the /F option when you typed the 
command. See Options below. 


You can't use CHKDSK with network, joined, or substituted drives. 


Options 


/F Fixes errors found in the directory. If you don't specify the /F 
option, MS-DOS displays what the results of any CHKDSK corrections 
would be without actually performing them. 


Whenever CHKDSK has to create a file for recovery purposes, it names 
the file FILEnnnn.CHK.  nnnn is a number, beginning with 0000. After 
CHKDSK is finished you can use the TYPE command to find out what's in 
any FlLEannn.CHK file. The file can be deleted if you don't find 

useful information in it. 


If you're sending the results (output) of CHKDSK to a file or a system 
device, you can't use the /F option. See Chapter 4 for more 
information on redirecting output. 


/V Displays all files and paths from the specified drive on the screen 
while CHKDSK operates. Displays errors, if any, that it finds. 
Examples 
A>CHKDSK B: 
Issues a status report on the disk in Drive B. For example: 
Volume DOS created May 8, 1985 2:05p 
362496 bytes total disk space 
22528 bytes in 2 hidden files 
2048 bytes in 2 directories 
30720 bytes in 8 user files 
307200 bytes available on disk 


393216 bytes total memory 
356288 bytes free 


C>\DOS\CHKDSK A:*.*/F 
Finds the CHKDSK command in the \DOS directory on Drive C. Issues a 
status report on the disk in Drive A, finds and displays any non- 


contiguous files, and fixes errors found in the directory or File 
Allocation Table. 
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Reference 
In this chapter, you should also read about these commands: 


COPY 
TYPE 


In addition, you'll find related information in the following chapter: 


Chapter 1, The DIR and CHKDSK Commands 
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CHMOD 


Purpose 


The CHMOD command is used to change and display the attributes of files. 


Syntax 


CHMOD [d: ][ path ] fi /ename [. ext ] [ *S|-S ][ *RI-R ][ +H|-H ][ +A|-A ]E *V|-v ] 


Type 


External 


Comments 


The CHMOD command provides a way to view or change the file attributes 
listed in the directory entry for a file. 


The file attributes that CHMOD displays are listed below: 


A (Archi ve) Signals that the file has not been backed up since 
you last modified it. 

S (System) Marks system files, volume labels, and directories 

R (Read-Onl y) Marks write-protected files (files that can be 
read from but not written to). 

H (Hidden) Marks files hidden by MS-DOS from normal use. 

V (Volume) Indicates a volume label (name of up to 11 
characters assigned to a disk for identification 
purposes). 

dir (Directory) Indicates a directory name. 


All attributes can be cleared or set by the user, except for V (Volume) and 
dir (Directory). These two serve as indicators for display only. 


To set an attribute for any file, follow the CHMOD command with the 
filename, a space, and the attribute letter with a plus sign (4) in front 
of it. To clear an attribute, use a minus sign (-) in front of the 
attribute symbol. 


You may set or clear more than one attribute at a time (see Examples 
below). 
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Spaces are not required between the attributes in the command line. If you 
are assigning more than one attribute at a time, you need only enter one 
plus sign (+) to cover both. Thus the following are both valid command 
lines: 
CHMOD WRIT.WRD +H +R 
CHMOD WRIT.WRD +HR 
You can use wildcard characters (* and ?) with filename. 
If you type CHMOD by itself, MS-DOS displays a brief description of the 
command and its attributes. 
Examples 
C>CHMOD DICK. TXT 
Displays the attributes of the file DICK.TXT, such as: 
DICK. TXT Poe: 3 TRG 
In this case, CHMOD is signaling that the file DICK.TXT has not been 
archived since it was last edited, and that it has the read-only 
attribute. 


C>CHMOD MEMO.TXT +R-H 


Assigns the R (Read Only) attribute and clears the H (Hidden) attribute 
from the file called MEMO.TXT. 


A>CHMOD B:*.* 


Asks for a display of the attributes of all the files in Drive B. The 
list might look like this: 


b CUST . DAT A.R 

b: BILL.DAT P ue 
b: MSDOS . SYS > v. 
b DATABASE <DIR> ASRHV 
4 files. 


Reference 
In this chapter, you should also read about the following command: 


ATTRIB 
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CLS (Clear Screen) 


Purpose 


The CLS command clears the display screen. 


Syntax 


CLS 


Type 


Internal 


Comments 
The CLS command is often used in batch processing files and application 
programs to clear the display before the next command is begun. The screen 


is cleared of all information, and an MS-DOS prompt appears in the upper 
left corner of the screen. 


Example 
A>CLS 


The screen is cleared and the A> prompt appears at the top of the 
screen. 
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COLOR 


Purpose 


The COLOR command allows you to select the color monitor as the active 
display. 
Syntax 


COLOR 


Type 
External 
As with all external commands, you can precede COLOR with the drive and 
path on which it is located. For example: A>C:\DOS\COLOR 
Comments 
The COLOR command changes the input/output (I/O) address of the video 
controller, allowing you to switch from monochrome to color mode. If you 
have two monitors attached to your computer, COLOR allows you to switch 
from the monochrome to the color monitor without setting the M/C switch on 
the rear panel of the computer. 
Example 
A>COLOR 
Switches from the monochrome to the color monitor. To return to the 
monochrome monitor, use the MONO command. 
Reference 


In this chapter, you should also read about the following command: 


MONO 
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COMMAND (Secondary Command Processor) 


Purpose 


Use COMMAND to start a new command processor. 


Syntax 


COMMAND [d: ][ path ][ device IVP ]U/C string] 


Type 


External 


As with all external commands, you can precede COMMAND with the drive and 
path on which it is located. For example: A>C:\DOS\COMMAND 


Comments 


The command processor (COMMAND.COM) is the MS-DOS program that contains all 
internal commands and processes external commands. Some application 

programs write over a transient portion of COMMAND.COM when they run. When 
this happens, the portion of the command processor that remains resident in 
memory looks for the COMMAND.COM file on disk so it can reload the 

transient portion. COMMAND is used most often by applications which 

provide access to MS-DOS from within the program, but can also be used in 
batch processing files. 


The device parameter allows you to specify a different device (such as AUX) 
for input and output. See the CITY command in this chapter for more 
information. 


The drive and path parameters following COMMAND control the environment 
inherited by the secondary command processor (see the SET command in this 
chapter for more information on the MS-DOS environment). Several 
environment options are possible: 


1. If drive and path are specified, a search is made of the specified 
directory for a copy of COMMAND.COM. Depending upon the outcome of the 
search, MS-DOS updates the COMSPEC parameter in the environment. This 


tells the secondary command processor where to look for COMMAND.COM if 
it needs to reload its transient portion. 
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a. If COMMAND.COM is found, MS-DOS loads a secondary command processor 
and includes the new drive and path in the environment COMSPEC 
statement. No PATH- or other strings are inherited from the 
primary command processor's environment. 


b. If a copy of COMMAND.COM is NOT found in the specified drive and 
path, an error message is displayed: 


Specified COMMAND search directory bad 


MS-DOS loads a secondary command processor and sets 

the environment COMSPEC statement to the default drive 
(e.g.,COMSPEC=\COMMAND.COM). No PATH= or other strings are 
inherited from the primary command processor's environment. 


2. If no drive and path are specified, the secondary command processor 
inherits the same environment as the primary. The COMSPEC statement 
and all other strings specified in the primary environment are 
inherited by the secondary command processor. 


Note: After loading a secondary command processor, if you then use the SET 
command to change the environment of the secondary command processor, it 
will not affect the environment of the primary. This allows you to modify 
the environment for a specific application and then return to the unchanged 
primary environment when finished. To return to the primary command 
processor, type: 


EXIT 


and press RETURN. The EXIT command always returns you to the previous 
level command processor and its environment. 


Options 


/P Instructs MS-DOS to make the new COMMAND.COM (the secondary command 
processor) permanent in memory. When you specify /P, MS-DOS can not 
exit to a previous level of command processor. You must restart MS-DOS 
to remove the secondary command processor. 


/C Allows you to pass a string containing a command to the secondary 
command processor. MS-DOS processes the command as if it were typed in 
at the MS-DOS prompt and then automatically exits to the primary 
command processor after it is completed. 


Note: If you specify the /P and /C options together, MS-DOS ignores 
the /P option. 
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Examples 
C»COMMAND A: 


Instructs MS-DOS to load a secondary command processor and, if 
COMMAND.COM exists on Drive A, to change the COMSPEC statement to 
reload the transient portion of the command processor from Drive A if 
necessary. 


A»COMMAND /C CHKDSK B: 


Loads a new command processor under the current program, executes the 
command CHKDSK B:, and exits to the primary command processor. 


COMMAND /C can also be used in a batch processing file to call another 
batch file. This allows you to chain several batch files together. 
For example: 


COMMAND /C SORTDIR DATE 


This command, placed in a batch file, loads a secondary command 
processor and executes the batch file SORTDIR, using the DATE 
parameter. After SORTDIR executes, MS-DOS returns to the primary 
command processor and executes the next line of the original batch 
file. See Chapter 6 for additional information on creating batch 
files. 


Reference 
In this chapter, you should also read about these commands: 


EXIT 
SET 
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COMP 


Purpose 
The COMP command compares the contents of a file, or a group of files, with 
others and verifies that they are identical. 

Syntax 


COMP [d: ][ path] £//ename[. ext ] [d: ][ path ][ f//ename [. ext ]] 


Type 
External 


As with all external commands, you can precede COMP with the drive and path 
on which it is located. For example: A>C:\DOS\COMP 


Comments 
COMP compares two files and tells you if they are identical or not. If 
theyre not, COMP tells you where it finds the differences. Use the COMP 
command to make sure that the copy of a file that you made is the same as 
the original. 
The first parameter is the source file. The second paramter is the target 
file. The files you're comparing may be on either the same drive or on 
different drives. They may be on the same path or on different paths. 
There are several ways to compare files: 


o Specify the source and target filenames. 


o Type COMP by itself. You are prompted for the source and target 
filenames. 


O To compare a group of files, use wildcard characters in the source and 
target filenames. 


o Specify a source and target drive or path without a filename. All the 


files on the drive in the current directory, or in the path, are 
compared. 
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Note: If the files to be compared are on two disks other than the MS-DOS 
disk, insert the MS-DOS disk in Drive A and the target disk in Drive B. 


Type: 
COMP 


This causes COMP to prompt you for filenames. When the drive light goes 
off, replace the MS-DOS disk in Drive A with the source disk and continue. 


If the files to be compared are identical, the following message appears on 
the screen: 


Files compare OK 
Compare more files (Y/N)? 


Type N (for NO) to stop comparing files. Type Y (for YES) to repeat the 
procedure with another set of files. 


The COMP command displays an error message if one of these problems occurs: 
o A specified path is invalid. 


o The two files being compared are different sizes. If the files being 
compared are not the same size, you see the message: 


Files are different sizes 
Compare more files (Y/N)? 


o A specified file can’t be found. 


If any data does not match in the files being compared, a message is 
displayed that indicates: 


O The location of the mismatch, in bytes, within the files. 
O The contents of those sections of the files. 
For example: 

Compare error at offset 000001 

File 1 = 65 

File 2 = 75 


If ten data mismatches are found, the COMP command halts and displays this 
message: 


10 mismatches - ending compare 


Some applications programs use files that are stored in exact 128 byte 
multiples. Sometimes the actual data in these files may be less than 
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exactly 128 bytes. COMP finds mismatches at the end of these types of 
files and gives you the message: 


EOF mark not found 
If this message appears on the screen, it does not necessarily mean that 


there is a problem. It may be telling you that compare errors occurred in 
the unusable portion of that file. It is usually followed by the message: 


Files compare OK 


Examples 
A»COMP JACK.TXT B:JACK.TXT 
Compares the file JACK.TXT on Drive A with the file JACK.TXT on Drive 
B 


A»COMP *.TXT B:*.DOC 


Compares all the files with an extension of .TXT on Drive A with the 
corresponding files on Drive B that have a .DOC extension. 


C>A:COMP \BROWN\ INVENTOR \WATERS\PATENTS\FEB 


Finds the COMP command on the disk in Drive A. Compares all the files 
in the two subdirectories \BROWN\INVENTOR and \WATERS\PATENTS\FEB on 


Drive C. 
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COPY 


Purpose 
The COPY command can be used to: 
o Copy one or more files to another disk. 


o Copy one or more files to the same disk, if a different filename is 
specified for the copy. 


o Combine (concatenate) files. See below, Combining Files. 


O Direct a file to another system device. See below, Directing Files to 
a System Device. 


Syntax 


COPY [/A]UB ][ 4: ][ path ][ filename [. ext J]JVA ][/B ] 
[ d: ][ path ]L filename [. ext JJVA ]U/B ]UV ] 


Or 
COPY [A ]/B ][ 4: ][ path] £//ename [. ext IVA 1UB ] 


+[ d: ][ path ] filename [. ext ]UA ]UB ]...] 
[ d: ][ path ][ filename [. ext ]1U/^ ]UB ][/V ] 


Or 
COPY [d: ][ path] filename [. ext ]+,, 


or 


COPY [d: ][ path ][ filename [. ext ]] device 


Type 


Internal 


Comments 


The first parameter is the source file. The second parameter is the target 
file. 


The COPY command must be followed by either a source path or a source 
filename or a combination of path and filename. Unless you specify a 
source drive, MS-DOS looks on the default drive for the source. 
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The following examples show how the COPY command works, depending on 
whether a source path or a source filename is specified. 


COPY path 


All the files in the path are copied to the root directory on the 
default drive. You can specify a target drive, path, or filename or a 
combination thereof. 


COPY f//ename drive 


The filename on the default drive is copied to the target drive. When 
you specify a source filename on the default drive, you must also 
specify a target drive, path, or filename or combination thereof. 


If the target is the same as the source, you need to specify a target 
filename that is different form the source filename. If you don’t, MS-DOS 
displays the message: 


File cannot be copied onto itself 
O File(s) copied 


If you specify a target different from the source, the target file can have 
the same name as the source file. If a file with that name already exists 
on the target, it is overwritten. 


You can precede source and target filenames with path. 


You can use wildcard characters with the COPY command. See Chapter 1, 
Wildcards for more information. 


Note: COPY *.* can be used to make backup copies of your disks. COPY *.* 
copies whole files and stores them in contiguous blocks on the target 

disk. This allows the disk drive to access files more quckly. If you use 
COPY *.* make sure the target disk: 

o Is formatted. 


o Has enough space to store all the files from the source disk. 
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Combining Files. The COPY command also lets you join (concatenate) files 
while copying. This is done by simply listing any number of files in the 
COPY command entry, each separated by a plus sign (+). Use the following 
syntax: 


COPY [/A]U/B ][ 4: ][ path ] Filename [. ext UA IPB ] 
+[ d: ][ path ] filename [. ext ]UA ]UB ]...] 
[ d: ][ path ][ fi /ename [. ext ]]U/A ]U/B ]UV ] 


The ellipsis (...) means that you can concatenate any number of files. The 
only restriction is the limit on the number of characters in the command 
line. 


Note: When COPY is used to combine files, it copies files only up to an 
end-of-file mark. Use the /B option to insure that entire files are copied 
across end-of-file markers. See Options below. 


The COPY command can also be used to give a new date and time to a file. 
The commas at the end of the following command indicate the end of the 
source file. COPY closes the file without actually appending anything and 
gives it the current date and time. Use the following syntax: 


COPY [d: ][ path] filename [. ext ]+,, 
Directing Files to a System Device. To copy to or from a system device, 
use a reserved device name as a second parameter. Use the following 
syntax: 

COPY [d: ][ path ][ £//ename [. ext ]] device 


Again, the COPY command must be followed by either a source path or 
filename or combination thereof. 


See Chapter 1, Reserved Filenames for more information on device names. 


You can create files using the COPY CON command. COPY CON tells MS-DOS to 
create a file with input from the keyboard. Use the following syntax: 


COPY CON [d: ][ path] filename [. ext ] 
For example, to create a file on Drive B named JOE.TXT: 


1. Type: copy con b:joe.txt 
Press RETURN. 


2. Type: This is the only line in the file and press F6 (end-of-file). 
Pressing the F6 key or CTRL Z puts an end-of-file mark in the file. It 
signifies that you have finished creating your file. 


3. Press RETURN. 
The file is saved on Drive B. 
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COPY writes the information you typed to the file you specified. See 
Chapter 6 for more information on COPY CON. 


Options 


/V Verifies that the file is being correctly copied. Use this option 
whenever you want to be certain that important data is being correctly 
recorded. When you use the /V option the COPY command runs more slowly 
because of the verification process. 


Note: If the MS-DOS VERIFY command is ON, the /V option is not needed. 


/A Indicates that the file is an ASCII file. If it is specified for the 
source file, then data from that file is copied up to, but not 
including, an end-of-file mark (CIRL Z). If it is specified for the 
target file, then an end-of-file mark is added to the end of the copied 
file. 


/B Indicates that the file is a binary data file. If it is specified for 
the source file, /B copies the entire file, including any end-of-file 
marks. If it is specified for the target file, then no end-of-file 
mark is added to the copied file. 
Note: /A and /B precede the file to which they apply. They also apply 
to subsequent files until another /A or /B is specified. 

Examples 
A>COPY VAMPIRE.BAT B: 


Copies the file VAMPIRE.BAT from the disk in Drive A to the disk in 
Drive B. The target file has the same name as the source file. 


C>COPY \WORD\NOTE.TXT \WORD\OLD 


Copies the file NOTE.TXT from the directory \WORD to the directory 
\WORD\OLD. 


A>COPY *.* B: 
Copies all the files on the default drive, Drive A, to the disk in 


Drive B. Any file on Drive B that has the same name as any file on 
Drive A is overwritten. 
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A»COPY MYFILE.DOC FILE1.DOC 


Copies the source file, MYFILE.DOC, onto the default drive, Drive A, 
and gives it a different name, FILE1.DOC. 


A»COPY MON. TXT+TUES.TXT+WED.TXT WEEK.TXT 


Joins the files MON.TXT, TUES.TXT, and WED.TXT and copies them into the 
file WEEK.TXT on the default drive. 


A»COPY *.PAT B:WORK.OLD 


You can also use wildcards to combine several files into a single 
file. This command takes all files from Drive A with the extension 
.PAT and combines them into a file named WORK.OLD on Drive B. 


ASCOMY *LSPPT.MERP T.PAT 


Joins each file with the extension .LST with a corresponding file with 
the extension .REF and gives it a .PAT extension. For example, a file 
named FILE1.LST is combined with a file named FILE1.REF to make a file 
named FILE1.PAT; a file named ABC.LST is combined with a file named 
ABC.REF to make a file named ABC.PAT, etc. 


A»COPY *.TXT+*.DOC LARGE . WP 


Combines all of the corresponding files with the extension .TXT and the 
extension .DOC into a single file, LARGE.WP. 


A»COPY *.REF ALL.REF 


Copies all the files with the .REF extension into a file called 

ALL.REF. COPY compares the source filename with the target filename. 
If they are the same, that single source file is skipped over. A 
Content of destination lost before copy message is displayed and the 
file joining process continues normally. 


A»COPY *.REF B:ALL.REF 


Copies all the files with the .REF extension into a file on Drive B 
called ALL.REF. If the file ALL.REF already exists on Drive B, an 
error results. When the error is detected, the ALL.REF file on Drive B 
is already destroyed. 


A>COPY ALL.LST+*.LST 


You can also append files. The example above appends all *.LST files 
to the ALL.LST file. 
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A»COPY BUDGET .ACT+,, 


Uses the COPY command to give a new date and time to the file 
BUDGET.ACT. The commas at the end of the command indicate the end of 
the source file. COPY closes BUDGET.ACT without actually appending 
anything and gives the file the current date and time. 


C»COPY \SUE\LETTERS\JOHN. TXT LPT1 


Sends a file, JOHN.TXT, in the \SUE\LEITERS subdirectory to the printer 
connected to LPT1. 


A»COPY /A CHAPTER1.DOC B: 
Copies the file CHAPTER1.DOC from Drive A to Drive B. The /A option 
indicates that the source file is an ASCII file. It is only copied up 
to the end-of-file mark. 

Reference 

In this chapter, you should also read about these commands: 
CHKDSK 
COMP 
DISKCOPY 
VERIFY 

In addition, you'll find related information in these chapters: 
Chapter 1, Reserved Filenames 


Chapter 1, Wildcards 
Chapter 6, Creating Batch Files: COPY CON 
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CITY 


Purpose 


The CITY command changes the standard input and output (I/O) device to an 
external device (such as a remote terminal) or restores the standard I/O 
device. 


Syntax 


CTTY device 


Type 


Internal 


Comments 


Normally you use the keyboard and monitor attached to the computer as the 
standard input and output device. Input comes from the keyboard, output is 
displayed on the monitor screen. The keyboard and monitor together are 
known as the primary console. 


CTTY lets you transfer control of your computer from the primary console to 
an external device (sometimes called an auxillary device). An external 
device is anything that allows input and output to the computer. For 
example, a printer equipped with a keyboard reads input from its keyboard 
and displays output as a printout. A remote terminal equipped with some 
type of modem can also be used as an external device. To transfer control 
to an external device, type CITY and the device (name of the port that the 
external device is attached to). 


External devices are typically connected to the AUX, COMI1, and COM2 ports 
(for a list of MS-DOS device names, see Chapter 1, Reserved Filenames). 
You must be certain that the external device is capable of both input and 
output operations. For example, you should not specify the name of a line 
printer (PRN) because the line printer only displays output. MS-DOS cannot 
read from it. 


Caution 


CITY NUL transfers control to a non-existent device. 


To return control to the keyboard and monitor, type CITY CON. 
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There are many programs such as GWBASIC that do not use MS-DOS function 
calls for input, output, or both. The CITY command has no effect on these 
programs because they do not input directly to the hardware. If you load 
GWBASIC while using CTTY, the standard input and output are reset to the 
keyboard and monitor. 


Note: If you have installed your own device drivers in a CONFIG.SYS file, 
CITY can accept them as device. 


Examples 
A»CTTY AUX 


Transfers control from the primary console to the external device 
connected to the AUX port. 


A»CTTY CON 


Restores the keyboard and monitor (the default setting) as the standard 
input and output device. 


Reference 
You'll find related information in these chapters: 
Chapter 1, Reserved Filenames 


Chapter 4 
Chapter 7 
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DATE 


Purpose 


The DATE command displays and allows you to reset the date. 


Syntax 
DATE [ mm-dd-yy ] 
Or 
DATE [dd-mm-yy ] 
Or 


DATE [ yy-mm-dd ] 


Type 


Internal 


Comments 


Use the DATE command to set the correct date. MS-DOS uses the current 


date, along with the current time, to mark your files as you create or 
change them. 


The date format is determined by the country code in the CONFIG.SYS file. 
The CONFIG.SYS file is created when you use SELECT to make a working copy 
of MS-DOS. See the SELECT command in this chapter or Chapter 7 for more 
information on CONFIG.SYS. 


If you type the DATE command by itself, the computer displays the date from 
its internal clock and asks you to set a new date. 


Current date is day mm-dd-yy 
Enter new date (mm-dd-yy): 


If you don't want to reset the date, press RETURN. Otherwise, type a new 
date and press RETURN. 


You can enter a new date simply by typing DATE and a value. 
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The following rules apply to setting the date: 
O 


The date must be entered using numerals only, letters are not 
permitted. Valid values are as follows: 


mm = 1-12 
dd = 1-31 
SX = 


80-99 or 1980-2099 


O You can 


use hyphens (-), slashes (/), or periods (.) to separate the 
date, month, and year entries. 


MS-DOS accepts the date entered if the values and separators are valid 
they are not valid, MS-DOS displays the message: 


Invalid date 
Enter new date: 


Type a valid entry for the date and press RETURN. 
Examples 


A>DATE 


The following message appears: 


Current date is day mm-dd-yy 
Enter new date: 


To leave the date as shown, press RETURN 
Or 


Enter a different date and press RETURN. 
A»DATE 9-3-85 


MS-DOS changes the date to Sept. 3, 1985. 


Reference 


SELECT 
TIME 


In this chapter, you should also read about these commands: 


In addition, you'll find related information in the following chapter: 
Chapter 7, COUNTRY 
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If 


DEL (Delete) or ERASE 


Purpose 


The DEL command removes designated files. 


Syntax 


DEL [d: ][ path ][ filename [ .ext ]] 


Type 


Internal 


Comments 
Use DEL to get rid of a file or a group of files that you no longer need. 
The drive and path tell MS-DOS where to find the filename you want to 
delete. If they’re not specified, MS-DOS looks on the default drive in the 


current directory. 


If you specify a drive or path but don’t specify a filename, MS-DOS assumes 
you want to delete all the files on the drive or path. 


You can use wildcard characters (* and 7?) to delete more than one file at a 
time. 


WARNING 

DEL permanently erases files. Be very careful, especially when you use 
DEL * * 

Keep the following points about the DEL command in mind: 

o DHL deletes only files. To delete directories use the RMDIR command. 
o Files with read-only status cannot be deleted. 


o You can type ERASE instead of DHL. 


Examples 
A»DEL NUM.BAT 


Deletes the file NUM.BAT from the disk in Drive A. 
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A>ERASE COUNT .BAS 
Deletes the file COUNT.BAS from the disk in Drive A. 
C»DEL \MARY\EDITS\RALPH. TXT 
Deletes the file RALPH.TXT from the \MARY\EDITS directory on Drive C. 
ADEL Br~% 
The following prompt is displayed: 
Are you sure (Y/N)? 


If you type Y (for YES) and press RETURN, all the files on the disk in 
Drive B are deleted. 


A»DEL B:*.BAK 


Deletes all the files with a .BAK extension on the disk in Drive B. 


Reference 
In this chapter, you should also read about the following command: 
RMDIR 
In addition, you'll find related information in the following chapter: 


Chapter 1 
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DIR (Show Directory) 


Purpose 


The DIR command displays the names of the files found on a disk or in a 
directory. It shows the size of each file as well as the date and time the 
file was created or last modified. 


Syntax 


DIR [d: ][ path ]D filename [ .ext JI/P ]UW ] 


Type 


Internal 


Comments 


Use DIR when you want a listing of all the files and subdirectories on a 
particular disk or in a particular directory. You can also request a 
directory listing for a specific file. Files are always displayed with 

their size in bytes and the time and the date they were last modified, 
except when the /W option is used (see Options below). DIR also displays 
the volume label of a disk and the amount of free space left, in bytes, on 
a disk. 


The drive and path tell MS-DOS where to find the directory or the filename 
that you want displayed. If they're not specified, MS-DOS looks on the 
default drive in the current directory. 


When you see «DIR» after a name, it indicates a subdirectory. 

If you enter a filename without an extension, all of the files with that 

filename are listed. If you enter a complete file specification, the file 

in the directory that has that exact file specification is displayed. 

Options 

/P Displays the directory listing one page at a time. With the /P option 
the directory pauses after the screen is filled. To restart the 
display of the directory, press a key. 

/W Selects wide display of the directory. With the /W option only 


filenames and their extensions are displayed. This usually allows the 
contents of the directory to fit on one page. 
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Examples 
A»DIR 
Displays all the files 
A»DIR B: 
Displays all the files 
A»DIR *.TXT 


Displays all the files 
Drive A. 


C»DIR NVINVENTORMPET 
Displays all the files 
C>DIR/W 
Displays all the files 


display. 


Reference 


on the default drive, Drive A. 


on Drive B. 


with a .TXT extension on the default drive, 


in the \PET subdirectory on Drive C. 


on the default drive, Drive C, as a wide 


You'll find related information in the following chapters: 


Chapter 1 
Chapter 3 
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DISKCOMP (Disk Compare) 


Purpose 
The DISKCOMP command compares two floppy disks to see if they are 
identical. DISKCOMP checks one disk against the other, track by track, and 
displays any compare errors on your screen. 


Syntax 


DISKCOMP [d:] [d: ]/1]/8] 


Type 
External 
As with all external commands, you can precede DISKCOMP with the drive and 
path on which it is located. For example: A>C:\DOS\DISKCOMP 

Comments 
Use the DISKCOMP command after you’ve used DISKCOPY to verify that the copy 
is correct. The disks to be compared must be of the same type, density, 
and number of sides. Do not use DISKCOMP to compare dissimilar media such 
as fixed disks and floppy disks. DISKCOMP displays the location of any 


error it finds and then continues the compare procedure. For example: 


Compare error on side O, track O 
Compare error on side 1, track O 


If there are no errors, the following message is displayed: 
Diskettes compare OK 

After comparing, DISKCOMP displays the prompt: 
Compare another diskette (Y/N)? 


To compare other disks, type Y (for YES). To stop comparing, type N (for 
NO). 


The first parameter is the drive that holds the source disk. The second 
parameter is the drive that holds the target disk. 
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If you omit both parameters, a single-drive compare is performed on the 
default drive. 


` If you enter one parameter and it's the default drive, a single-drive 
compare is performed on the default drive. 


If you enter one parameter and it's not the default drive, that parameter 
is treated as the source drive. 


If you enter both parameters, a dual floppy-drive compare is performed. 

On a fixed-disk system DISKCOMP performs a single-drive compare. It pauses 
and asks you to insert the source and target disks at the appropriate 

times. DISKCOMP can't be used to compare a floppy disk and a fixed disk. 
You can't use DISKCOMP on network, joined, substituted, or assigned drives. 
Note: If you made a copy of a disk with COPY *.* DISKCOMP may not verify 
the copy. COPY *.* copies files in a special way (see the COPY command). 
Use the COMP command to compare individual files on a disk created with 
COPY ** 


Options 


/1 Causes DISKCOMP to compare only one side of each disk (side O). The 
following message is displayed: 


Comparing 40 tracks 
9 Sectors/Track, 1 Side 


/8 Indicates that only sectors 1 through 8 should be compared on the 
disks. The following message is displayed: 


Comparing 40 tracks 
8 Sectors/Track, 2 Sides 
Examples 
A»DISKCOMP A: B: 


Compares the disk in Drive A with the disk in Drive B. 
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C> \DOS \D I SKCOMP 
Finds the DISKCOMP command in the \DOS directory on Drive C and 
performs a single-drive compare on Drive A. The following prompt is 


displayed: 


Insert FIRST diskette in drive A: 
Strike any key when ready 


As the DISKCOMP procedure continues, you are prompted to insert the 
source and target disks at the appropriate times. 


Note: The " first diskette" is the source disk. The " second 
diskette" is the target disk. 
Reference 


In this chapter, you should also read about these commands: 


COPY 
DISKCOPY 
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DISKCOPY 


Purpose 

The DISKCOPY command copies the contents of one disk to another. 
Syntax 

DISKCOPY [dz] Id: ]U/1 
Type 

External 


As with all external commands, you can precede DISKCOPY with the drive and 
path on which it is located. For example: A>C:\DOS\DISKCOPY 


Comments 


Use the DISKCOPY command to make copies of a disk. It’s particularly 
useful when you want to make a backup copy of your work. 


Before the DISKCOPY procedure begins, you are prompted to insert the 
appropriate disks. After copying, DISKCOPY displays the prompt: 


Copy another diskette (Y/N)? 
To copy another disk, type Y (for YES). To stop copying, type N (for NO). 


During the copy procedure, DISKCOPY displays the location of any disk error 
that it finds, and then continues. The resulting copy may or may not be 
usable. 


The first parameter is the drive that holds the source disk. The second 
parameter is the drive that holds the target disk. 


If you omit both parameters, a single-drive copy is performed on the 
default drive. 


If you enter one parameter and it's the default drive, a single-drive copy 
is performed on the default drive. 


If you enter one parameter and it's not the default drive, that parameter 
is treated as the source drive. 


If you enter both parameters, a dual floppy-drive copy is performed. 


MS-DOS Commands / 5-51 


DISKCOPY automatically formats the target disk if it is not already 
formatted. It checks the number of physical sectors on the source disk and 
formats the target disk to the same capacity and format. 


DISKCOPY automatically determines the number of sides to copy based on the 
source drive and disk, unless you specify the /1 option. See Options 
below. 


On a fixed-disk system DISKCOPY performs a single-drive copy. It pauses 
and asks you to insert the source and target disks at the appropriate 
times. DISKCOPY can't be used to copy to or from a fixed disk. 


It's a good idea to run DISKCOMP with the source and target disks after the 
DISKCOPY procedure is finished. This insures that the copy you've just 
made is correct. 


You can't use DISKCOPY on network, joined, substituted, or assigned drives. 
Note: Disks that have had a lot of file activity may be fragmented because 
space on the disk is no longer allocated sequentially. A fragmented disk 
performs slowly due to delays in finding, reading, or writing a file. 
COPY *.* copies everything from one disk to another. It works differently 
than DISKCOPY, however, in that it puts files onto the target disk as whole 
units. Use COPY to copy a disk that has had a lot of activity. See the 
COPY command. 

Options 


/1 Causes DISKCOPY to copy only the first side of the source disk. The 
following message is displayed: 


Copying 40 tracks 
9 Sectors/Track, 1 Side 


Examples 
A>DISKCOPY A: B: 


Copies the contents of the disk in Drive A to the disk in Drive B. 
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C> \DOS \D I SKCOPY 
Finds the DISKCOPY command in the \DOS directory on Drive C and 
performs a single-drive copy on Drive A. The following prompt is 
displayed: 


Insert SOURCE diskette in drive A: | 
Press any key when ready... 


As the DISKCOPY procedure continues you are prompted to insert the 
source and target disks at the appropriate times. 


Reference 
In this chapter, you should also read about these commands: 


COPY 
DISKCOMP 


MS-DOS Commands / 5-53 


EXE2BIN 


Purpose 


The EXE2BIN command converts .EXE (executable) files to .BIN or .COM 
(binary) file format. 


Syntax 


EXE2BIN [d: ][ path] £//ename[ .ext] [d: ][ path] fi/ename[ .ext ] 


Type 
External 


As with all external commands, you can precede EXE2BIN with the drive and 
path on which it is located. For example: A>C:\DOS\EXE2BIN 


Comments 


Using EXE2BIN to convert your executable files into binary format allows 
faster program loading and conserves space on the disk. 


The first parameter is the input (.EXE) file. The drive and path may be 
specified. The input file must be in valid .EXE format produced by a 
linker. The resident, or actual code and data, part of the file must be 
smaller than 64K. There must be no STACK segment. 


If you do not specify an extension for the input filename, .EXE is assumed. 


The second parameter is the output (.BIN) file. If you do not specify a 

drive and path, the drive and path of the input file are assumed. If you 
do not specify a filename, the filename of the input file is assumed. If 
no extension is specified, .BIN is assumed. 


Two kinds of conversions are possible, depending upon whether the initial 
CS:IP (Code Segment: Instruction Pointer) is specified in the .EXE file: 


1. If CS:IP is not specified in the .EXE file, a pure binary conversion is 


assumed. If segment fixups are necessary (i.e., when the program 
contains instructions requiring segment relocation), you are prompted 
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for the fixup value. This value is the absolute segment at which the 
program is to be loaded. You may continue execution by typing a valid 
hexadecimal number and pressing RETURN. 


The resulting program is usable only when loaded at the absolute memory 
address specified by a user application. The command processor will 
not be capable of properly loading the program. 


2. If CS:IP is specified as 0000:100H, it is assumed that the file is to 
be run as a .COM file, with the location pointer set at 100H by the 
assembler statement ORG. The first 100H bytes of the file are 
deleted. No segment fixups are allowed, because .COM files must be 
segment relocatable (they must assume the entry conditions explained in 
the Microsoft Macro Assembler Manual). 


Once the conversion is complete, you may rename the resulting file with 
a .COM extension. The command processor will then load and execute the 
program in the same way as the .COM programs supplied on your MS-DOS 
disk. 

If CS:IP does not meet either of these criteria, if it meets the .COM file 

criterion but has segment fixups, or if the file is not a valid executable 

file, MS-DOS displays the message: 
File cannot be converted 

To interpret other error messages, see Appendix B, MS-DOS Message 

Directory. 

Examples 
A>EXE2BIN A:PROGRAM1 B: 


Converts input file PROGRAMI.EXE on Drive A to output file PROGRAM1.BIN 
on Drive B. 


C>EXE2BIN C: \DEVELOP\PROGRAM4 . ASM C: \LIBRARY\ACCOUNTS.BIN 


Converts input file PROGRAM4.ASM from the DEVELOP directory to output 
file ACCOUNTS.BIN in the LIBRARY directory. 
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EXIT 


Purpose 
The EXIT command exits from the current MS-DOS command processor and 
returns to the previous application program or command processor. 
Syntax 


EXIT 


Type 


Internal 


Comments 
Some application programs provide access to MS-DOS from within the 
program. The EXIT command is often used to return to the program after 
using the command processor. 
For example, if you want to check disk space while running such an 
application, follow the program's instructions to exit to MS-DOS, then 
enter the CHKDSK command. To return to the program, use the EXIT command. 
The EXIT command is also used within MS-DOS to exit from a secondary 
command processor to the previous-level command processor. 

Reference 


In this chapter, you should also read about these commands: 


COMMAND 
SET 
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FDISK 


Purpose 
The FDISK command is used to create, change, display, or delete partitions 
on a fixed disk. 

Syntax 


FDISK 


Type 
External 
As with all external commands, you can precede FDISK with the drive and 
path on which it is located. For example: A>\DOS\FDISK 

Comments 
Use the FDISK command to designate the amount of space you want to use for 
the MS-DOS partition. Then, before you can use the MS-DOS partition, you 
need to format it and then copy the external MS-DOS files on it. See the 
FORMAT and COPY commands in this chapter. 
You can also use FDISK to: 
o Change the active partition. 
o Delete the MS-DOS partition. 
o Display the partition map. 
If you want to install any other operating system, follow the instructions 
provided with it. 


Reference 


Refer to Chapter 2 for complete information on using the FDISK command. 
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FIND 


Purpose 


The FIND command searches for a string of text in the specified file(s). 


Syntax 


FIND [/V IVC ]UN ] "string" [d: ][ path] filename [ .ext ] [...] 


Type 

External 

As with all external commands, you can precede FIND with the drive and path 

on which it is located. For example: A>C:\DOS\FIND "procedure"AUTOEXEC.BAT 
Comments 

The FIND command is a filter (see Chapter 4 for information on filters). 

FIND reads the specified file and discards any line that doesn't contain 

the string. FIND then displays the lines from the file that contain the 


string. 


The drive and path tell MS-DOS where to find the filename. If they're not 
specified, MS-DOS looks on the default drive in the current directory. 


The ellipsis (...) means that you can specify more than one file to search 
for the string. 


The following rules apply to using FIND: 
o  Wildcard characters (* and ?) are not permitted in filename. 
o FIND recognizes upper- and lowercase letters. 
o String must be enclosed in quotes. If you want to use a quotation mark 
within string, type a double quote. 
Options 
/V FIND displays all the lines that do not contain the string. 


/C FIND counts the number of lines that contain the string and displays 
that number. 


/N FIND precedes each line containing the string with its relative line 
number in the file. 
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Examples 
A>FIND "Di ck"PHONE.LST 


Finds and displays all the lines in PHONE.LST that contain Dick. For 
example: 


---------- phone. Ist 
Charles Dickens 

Dick Monahan 

Fuschia Dickerson 


If you wanted to find only Dick and not its variations (such as 
Dickens), then you would type a space after the k in Dick. For 
example: 


"Dick * 
A>FIND "Dick"PHONE.LST | SORT >SORTED.LST 
Finds all the lines in PHONE.LST that contain Dick and sends them as 
input to the SORT command. SORT puts the lines in alphabetical order 
and sends the result to a file called SORTED.LST. If SORTED.LST 
doesn’t already exist, MS-DOS creates it for you. 
C^FIND /N """I'll always remember you, Fred."""SCRIPT.TXT 


Finds all the lines in SCRIPT.TXT that contain "I'll always remember 
you, Fred." Each line is preceded by its line number in the file. For 


example: 

Se pera ioe SCript.txt 

[13]"I‘ll always remember you, Fred." His mother broke into tears. 

[25]"I' I| always remember you, Fred." Mary kissed the photo. 

[49]"I' || always remember you, Fred." George saluted the flag. 

[52]"I' || always remember you, Fred." Sue checked her wallet. 

[78]"I' I | always remember you, Fred." Jack threw the football. 
C^FIND /C """|'I| always remember you, Fred."""SCRIPT.TXT 


Counts the lines in SCRIPT.TXT that contain "Ill always remember you, 
Fred." For example: 


eaea soript.txte 5 


Reference 
You'll find related information in the following chapter: 


Chapter 4 
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FORMAT 


Purpose 
The FORMAT command prepares disks to store MS-DOS files. Disks must be 
formatted before they can be used by MS-DOS. 

Syntax 


FORMAT [d: J/S]/1]/V IVB ][/8 ] 


Type 
External 
As with all external commands, you can precede FORMAT with the drive and 
path on which it is located. For example: A>C:\DOS\FORMAT 

Comments 


A disk has to be prepared so that it can store your files. The FORMAT 
command: 


O Creates units of storage, called sectors, on the disk. 


o Initializes the beginning sectors to include a boot sector, a File 
Allocation Table, and a directory. 


o Checks the disk for defective areas and marks them so they won't be 
used. 


o Issues a status report on the formatted disk with information on total 
space and bytes available on disk. If applicable, it also lists the 
number of defective bytes or the number of bytes used by system files. 

WARNING 

Formatting a disk destroys all information on it. Before you format a 


disk, use DIR to see what's on it. That way you won't lose any needed 
files. 


You can specify a drive with FORMAT. If no drive is specified, the disk in 
the default drive is formatted. 


You can't use FORMAT on network, joined, substituted, or assigned drives. 
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Fixed Disks. You usually format a fixed disk only once. If you decide to 
change any of the partitions on the fixed disk, you'll need to reformat 


it. 


See Chapter 2 for more information on formatting a fixed disk. The /1 


and /8 options are not available on fixed disks. 


You should always specify a drive when you use the FORMAT command on a 
fixed-disk system, so that you don't inadvertently format the fixed disk 
itself. 


Options 


/S 


/1 


/8 


/B 


Examples 


Copies the hidden system files and COMMAND.COM onto the disk that 
you're formatting. The files are copied in the following order: 


IO.SYS 
MSDOS.SYS 
COMMAND.COM 


IO.SYS and MSDOS.SYS are hidden files, and therefore do not appear in 
any directory search. 


Note: FORMAT/S makes a disk bootable. It does not, however, install a 
keyboard driver, date and time formats, or the clock driver. To 

install a keyboard driver you need an AUTOEXEC.BAT file (see Chapter 
6). To install time and date formats and the clock driver, you need a 
CONFIG.SYS file (see Chapter 7). 


Formats a disk for single-sided use. 


Formats a disk with 8 sectors per track. Space is not reserved for the 
hidden operating system files. The /8 option is for disks you use with 
MS-DOS 1.0. 


Causes FORMAT to prompt for a volume label after the disk is formatted. 


Formats a disk with 8 sectors per track and reserves space for the two 
hidden system files. This allows you to put system files from any 

version of MS-DOS on a disk with the SYS command. If you don’t specify 
/B, you can only put system files from version 3.10 on a disk. You 

can’t use /S or /V with the /B option. 


A>FORMAT B:/S/V 


Formats a disk in Drive B, writes the hidden system files and 
COMMAND.COM onto the disk, and then prompts for a volume label for the 
disk. 
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MS-DOS prompts you to insert the disk to be formatted before the 
procedure begins. When the procedure is complete, you see the message: 


Formatting...Format complete 
System transferred 


Volume label (11 characters, ENTER for none)? 
You can enter a volume label or just press RETURN. 
xxxxxx bytes total disk space 
xxxx bytes used by system 
xxxxxx bytes available on disk 
Format another (Y/N)? 
To format another disk, type Y (for YES) and press RETURN. To stop 
formatting, type N (for NO) and press RETURN. 
A»C:FORMAT 


Finds the FORMAT command on Drive C and then formats the disk in Drive 
A. 


A>FORMAT B:/B 
Formats a disk in Drive B with 8 sectors per track and leaves room for 
system files. 
Reference 


In this chapter, you should also read about these commands: 


LABEL 
SYS 


In addition, you'll find related information in the following chapter: 


Chapter 2, Formatting the MS-DOS Partition 
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GRAFTABL 


Purpose 
The GRAFTABL command loads a table of data which defines additional 
characters for use by graphics programs. 

Syntax 


GRAF TABL 


Type 
External 
As with all external commands, you can precede GRAFTABL with the drive and 
path on which it is located. For example: A>C:\DOS\GRAFTABL 

Comments 
The GRAFTABL command permits the monitor to display foreign-language 
characters or the extended ASCII characters 128 through 255 when in 
graphics mode. This command increases the resident size of MS-DOS in 
memory. 
GRAFTABL should be executed only once, usually at the time that MS-DOS is 
loaded. 

Example 
A»GRAF TABL 


Loads the character table and initializes the interrupt vector. MS-DOS 
responds with the message: 


GRAPHICS CHARACTERS LOADED 


The MS-DOS prompt is displayed. If you try to execute the command a 
second time, MS-DOS will prompt: 


GRAPHICS CHARACTERS ALREADY LOADED 
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GRAPHICS 


Purpose 
The GRAPHICS command lets you print any screen graphics on an 
IBM-compatible graphics printer. 

Syntax 


GRAPHICS [ printer] UR ]VB ] 


Type 


External 


As with all external commands, you can precede GRAPHICS with the drive and 
path on which it is located. For example: A>C:\DOS\GRAPHICS 


Comments 


The GRAPHICS command allows you to print graphics displayed on the screen 
by pressing the SHIFT PRTSC keys. If the GRAPHICS command is not issued, 
only text characters are printed. 


The GRAPHICS command requires an IBM-compatible graphics printer. See your 
printer manual to determine compatibility with the printer types listed 
below. 


To specify the type of printer you are using, you can substitute any of the 
following for the printer variable: 


COLOR1 IBM Personal Computer Color Printer (or compatible) with 
black ribbon. 

COLOR4 IBM Personal Computer Color Printer (or compatible) with 
RGB (red, green, blue, black) ribbon. 

COLORS IBM Personal Computer Color Printer (or compatible) with 
CMY (cyan, magenta, yellow, black) ribbon. 

COMPACT IBM Personal Computer Compact Printer (or compatible). 

GRAPHICS IBM Personal Computer Graphics Printer (or compatible). 


If you do not specify printer, the GRAPHICS variable is supplied as a 
default. 
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Text prints in about 30 seconds; graphics may take up to three minutes, 
depending upon your graphics printer. When printing a graphics screen 
display, note the following: 


o Using the GRAPHICS command increases the amount of memory used by 
MS-DOS by approximately 2K. 
o In 320 x 200 color graphics mode on printer types COLOR1 and GRAPHICS, 
the screen image is printed in up to four shades of gray. 
o In 640 x 200 graphics mode, the screen is printed sideways on the 
paper. The upper-right screen appears in the upper-left on the paper. 
o To print a graphics display screen from an assembly language program, 
use the following coding example: 
PUSH BP 
INT 5 
POP BP 
Options 
/R Prints black and white on the printer as displayed on the monitor. If 
you do not specify /R, black is printed as white and white is printed 
as black. 
/B Prints the background screen color for printer types COLOR4 and 
COLORS. If you do not specify /B, the background color is not printed. 
Examples 
A>GRAPHICS 


When you press the SHIFT PRTSC keys, the current contents of the screen 


are printed. The printer type defaults to GRAPHICS. 


A>GRAPHICS COLOR8 /B /R 


When you press the SHIFT PRTSC keys, the current contents of the screen 


are printed. On a COLORS8-type printer, the background color is 
printed, black prints as black, and white prints as white. 
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JOIN 


Purpose 
The JOIN command is used to connect a drive to a directory on another 


drive. A directory is formed on the second drive that contains the 
contents of the first drive. 


Syntax 


JOIN [d: d:\directory ] 


Or 
JOIN d: /D 
Type 
External 


As with all external commands, you can precede JOIN with the drive and path 
on which it is located. For example: A>C:\DOS\JOIN 

Comments 
JOIN combines the first parameter with the second parameter. 


The first parameter is the drive that you want to join to a directory on 
another drive. It can't be the default drive. 


The second parameter is the drive and directory that you are combining with 
the first parameter. It has to follow these rules: 


o The drive can't be the default drive. 

o The directory has to be empty except for . and .. entries. 

o The directory can't be the root or the current directory. 

o The directory has to be on the first level below the root directory. 

o You can use a directory currently on the drive, as long as it's empty, 


or you can type a name and JOIN will create a new directory with that 
name. 


5-66 /MS-DOS Commands 


When you run the CHKDSK command on a joined drive, you get the following 
message: 


Directory is joined, 
tree past this point not processed 


This message is followed by CHKDSK information for the drive of the second 
parameter only. 


If you type JOIN by itself, MS-DOS displays the join that is currently in 
effect (if there is one). 


As long as a join is in effect you can't use the RMDIR command to remove 
the joined directory. 


Use the /D option when you want to disconnect the joined drive. See 
Options below. 


You can't use JOIN on network drives. It is recommended that you avoid 
using SUBSTITUTE, ASSIGN, and XASSIGN where a join is in effect. Don’t use 
BACKUP, RESTORE, FORMAT, DISKCOPY, or DISKCOMP where a join is in effect. 


Options 


/D Disconnects a joined drive. Follow the first parameter with the /D 
option. For example: 


JOIN d: /D 
After a joined drive is disconnected you'll notice that anything 
created in the directory of the second parameter while the join was in 
effect is returned to the drive of the first parameter. The directory 
of the second parameter is now empty --just as it was when you started. 
Note: To avoid problems, always exit a joined drive through the root 
directory. 


Examples 


Assume there's a virtual Drive E, in addition to Drives A and C, on a 
fixed-disk system. The directory structure of Drive C is pictured below. 


MS-DOS Commands / 5-67 





Figure 5-2 Drive C -- Directory Structure 


The directory structure of Drive E is pictured below. 





Figure 5-3 Drive E -- Directory Structure 


A>C:\DOS\JOIN C: E: MBIGDRIVE 


Joins Drive C to Drive E. The directory structure of Drive E now looks 
like this: 





Figure 5-4 Drives C and E Joined 
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The contents of Drive C are stored in the \BIGDRIVE directory on Drive 
E. Any reference made to Drive C will now result in the message: 


Invalid drive specification 


Note: In the example above there is no \BIGDRIVE directory on Drive E 
to begin with. It’s automatically created. The NDATA directory on 
Drive E could have been used with JOIN if it were empty. In that case, 


the following command would join Drive C to the NDATA directory on 
Drive E: 


A>C:\DOS\JOIN C: E:\DATA 


A>E : \B IGDR I VE \DOS\ JOIN 


Finds the JOIN command in the \BIGDRIVE\DOS subdirectory. Since JOIN 
isn't followed by any parameters, MS-DOS displays any join that's 
currently in effect. For example: 


C: => E:\BIGDRIVE 


A>E:\BIGDRIVE\DOS\JOIN C: /D 


Finds the JOIN command in the \DOS subdirectory. The /D option 
disconnects the joined drive composed of Drives E and C. The former 


structure reappears except that Drive E now has an empty directory 
called \BIGDRIVE. 


Reference 


In this chapter, you should also read about the following command: 


VDISK 


In addition, you'll find related information in the following chapter: 


Chapter 7, DEVICE 
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KEYBxx 


Purpose 
The KEYBxx command loads alternate keyboard driver programs to support 
non-U.S. keyboards. 

Syntax 


KEYBxx 


Type 
External 


As with all external commands, you can precede KEYBxx with the drive and 
path on which it is located. For example: A>C:\DOS\KEYBFR 


Comments 


The KEYBxx command loads into memory a keyboard driver program that 
replaces the standard U.S. English keyboard driver. Five keyboard drivers 
have been provided on your MS-DOS disk; the xx variable indicates the 
driver as follows: 


KEYBUK Loads the United Kingdom English-language keyboard driver. 
KEYBGR Loads the German-language keyboard driver. 
KEYBFR Loads the French-language keyboard driver. 
KEYBIT Loads the Italian-language keyboard driver. 
KEYBSP Loads the Spanish-language keyboard driver. 


Loading each keyboard driver increases the amount of memory used by MS-DOS 
by approximately SK. 


Only one keyboard driver should be loaded after starting MS-DOS. Once 
loaded, the program remains resident in memory until you reset or turn off 
the computer. If you load a second keyboard driver, it will gain control 
of the keyboard, but the previous keyboard driver will still occupy space 
in memory and cannot be accessed. 


Once you load an alternate keyboard driver using KEYBxx, you can toggle 
from it to the standard U.S. keyboard driver by holding down the CTRL and 
ALT keys and then pressing F1. Press CTRL ALT F2 to return to the 
alternate keyboard driver. 
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Note: If your system has multilingual keyboard support through special ROM 
BIOS, you won't be able to switch between keyboards using the above key 
sequences. 

Example 
A>KEYBGR 


Loads the German keyboard driver. 


Reference 
In this chapter, you should also read about the following command: 
SELECT 
In addition, you'll find additional information in the following chapter: 


Chapter 7, COUNTRY 
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LABEL 


Purpose 
The LABEL command is used to create, change, or delete the volume label of 
a disk. 

Syntax 


LABEL [d: ][ vo/ume /abe/ ] 


Type 
External 
As with all external commands, you can precede LABEL with the drive and 
path on which it is located. For example: A>C:\DOS\LABEL 

Comments 
Whenever you format a disk for use by MS-DOS you have the option of giving 
it a volume label with FORMAT/V (see the FORMAT command). Use the LABEL 
command to change or delete a volume label assigned with FORMAT/V. If you 
didn't specify the /V option when you formatted a disk, you can use LABEL 
to give the disk a volume label. 
The volume label is the name you give a disk. Whenever you create or 
change a disk label, MS-DOS gives the disk a date and time stamp. You can 
view the date and time stamp with CHKDSK. 


You can specify the drive that holds the disk that you want to label. 
Otherwise MS-DOS labels the disk in the default drive. 


If you type LABEL without specifying a volume label, you see the prompt: 
Volume label (11 characters, ENTER for none)? 

The following rules apply for a volume label: 

o It can have up to 11 characters. 


O Valid characters for a volume label are the same as valid characters 
for a filename (see Chapter 1). In addition, LABEL allows spaces. 


To display the volume label of a disk, use the VOL command. 
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You can't use LABEL on network, substituted, or assigned drives. 


Examples 
A>LABEL B:BASIC GAMES 


The volume label BASIC GAMES is given to the disk in Drive B. The 
current date and time are recorded with the volume label. 


A»LABEL 
The following message is displayed: 
Volume label (11 characters, ENTER for none)? 
To give a disk a volume label, type a name. 
Or 
To delete the current label, press RETURN. You see the prompt: 
Delete current volume label Y/N? 


To delete the current volume label, type Y (for YES). To keep the 
current volume label, type N (for NO). 


Reference 


In this chapter, you should also read about these commands: 


FORMAT 
VER 
VOL 
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MKDIR or MD (Make Directory) 


Purpose 
The MKDIR command creates a new directory in a multilevel directory 
structure. 
Syntax 
MKDIR [d: ] path 
or 


MD [d: ] path 


Type 


Internal 


Comments 


You use MKDIR to create a multilevel directory structure. A multilevel 
directory structure consists of directories and subdirectories that grow 
down from the root (top) directory. MD can be used as an abbreviation for 
MKDIR. 


MKDIR can be followed by: 


o A drive, to indicate the drive on which you want to create a 
directory. Otherwise the directory is created on the default drive. 


o A path, to indicate where in the structure you want to create a new 
directory. 


A backslash character (X) can precede path. A leading backslash 
character tells MKDIR to start at the root directory. Otherwise MKDIR 
works from the current directory. 


Valid characters for directory and subdirectory names are the same as valid 
characters for filenames (see Chapter 1). 


Note: The number of characters in a path, including backslash characters, 
should not exceed 64. 
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Examples 
C»MKDIR \PAYROLL 
Makes a directory called NPAYROLL in the root directory. 
C>MD \PAYROLL V JUNE 


Makes a subdirectory called \JUNE under the \PAYROLL directory. 


Reference 


In this chapter, you should also read about these commands: 


In addition, you'll find related information in the following chapter: 


Chapter 3 
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MODE 


Purpose 
The MODE command sets the mode of operation on a printer, a display 
monitor, or an RS-232C communications port. It lets you define some of the 
operating characteristics of your computer. 
Syntax 
MODE LPT *:[ » ]L.E » ]E .P 1] 
Or 
MODE n or MOD [n],m[,T] 
Or 
MODE COM»: baud [ ‚parity [ ‚databits [ , stopbits [ ,P ]1]]] 
Or 


MODE LPT*:; = COM^» 


Type 
External 
As with all external commands, you can precede MODE with the drive and path 
on which it is located. For example: A>C:\DOS\MODE 80 

Comments 
The MODE command has four options: 
Option 1. This MODE option sets the characteristics for a parallel 
printer. You can specify for each printer the number of characters on each 
line, the number of lines per inch, and a retry option in the event of 
timeout errors. The settings specified must match any that have been set 
manually on your printer. The syntax is: 


MODE LPT#: [ » ]L,[ » ]L ,P 1] 


Replace the * with the printer number (LPT1:, LPT2:, or LPT3:). 
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The n variable sets the number of characters per line (80 or 132). If n is 
not specified, the default is 80. 


The m variable sets the number of lines per inch (6 or 8). If m is not 
specified, the default is 6. 


The P option specifies continuous retry on timeout errors. If P has been 
entered, you can stop the retry loop by pressing CTRL BREAK. To prevent 
retry of timeout errors, enter MODE without specifying P. Use of the P 
option increases the amount of memory used by MS-DOS. 


Note: If you are using an application program like GWBASIC which 


initializes the printer as part of its operation, any values set by MODE 
are reset to their default values when the program is started. 


Option 2. This MODE option switches display monitors and, optionally, sets 
the display mode and generates a test pattern to align the display. The 
syntax is: 

MODE n 

or 


MODE [n],m[,T] 


The n variable sets the number of characters displayed per line and enables 
or disables color display. The valid entries for n are: 


MONO Selects the monochrome display with 80 characters per line. 

40 Sets the color display to 40 characters per line. 

80 Sets the color display to 80 characters per line. 

BW40 Sets the color display to 40 characters per line in monochrome 
mode. 

BW80 Sets the color display to 80 characters per line in monochrome 
mode. 

CO40 Sets the color display to 40 characters per line in color mode. 

CO80 Sets the color display to 80 characters per line in color mode. 
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The m variable shifts the display to the right or left to align text with 

the edge of the screen. The display is shifted one character in 40-column 
mode and two characters in 80-column mode. Using this option increases the 
memory used by MS-DOS. The valid entries for m are: 


R Shifts display to the right. 
L Shifts display to the left. 


The T option, used together with the m variable, generates a test pattern 
to check alignment. If you specify T, a test pattern is displayed and a 
prompt asks you if the screen is aligned correctly. If the screen is out 

of alignment, type N to repeat the shift you specified in m. Type Y to end 
the command. 


Option 3. This MODE option initializes the protocol of the RS-232C 
asynchronous communications port. The settings specified must match any 
that have been set manually on your printer. The syntax is: 


MODE COMn: baud [ ‚parity [ ,databits [ ,stopbits[ ,P ]]1] 
Replace the n with the communications port number (COM1 or COMO). 


The baud variable sets the speed at which data is transmitted. You must 
specify baud when using this option of MODE. The choices are: 11 (110 
baud), 15 (150 baud), 30 (300 baud), 60 (600 baud), 12 (1200 baud), 24 
(2400 baud), 48 (4800 baud), or 96 (9600 baud). 


The parity variable can be N (none), O (odd), or E (even). The default 
value is E (even). 


The databits variable sets the number of bits of data that are 
transmitted. The options are 7 or 8. The default value is 7. 


The stopbits variable sets the number of stop bits transmitted after each 
character of data. The options are 1 or 2. If baud is 110, the default is 
2; for all other baud settings, the default is 1. 


If you omit the parity, databits, and stopbits variables, MS-DOS will 
supply the default values. Entering only a comma for any variable also 
causes MS-DOS to supply the default value. See Examples below. 


The P option indicates that COMn is being used for a serial interface 
printer and specifies a continuous retry option for timeout errors. If P 
has been entered, you can stop the retry loop by pressing CTRL BREAK. To 
prevent retry of timeout errors, enter MODE without specifying P. Use of 
the P option increases the amount of memory used by MS-DOS. 
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Option 4. This MODE option redirects all printer output normally directed 
to LPT* to the RS-232C communications port specified in COMn. The syntax 
is: 


MODE LPT£; =COMn 


Replace the * in the first parameter with the printer number (1 to 3) you 
are redirecting. 


Replace the n in the second parameter with the RS-232C communications port 
number (1 or 2) that you want output directed to. 


MS-DOS directs all printer output to LPT1 as a default. To use a serial 
interface printer, you must redirect output to COM1 or COM2. 


Two MODE commands are necessary. Before using MODE Option 4 to redirect 
printer output to a serial device, you must initialize the RS-232C port 
using MODE Option 3. For example: 


MODE COM1:24,N,8, 1,P 
MODE LPT1:=COM1 


In this example, the first MODE command sets the COMI1 port protocol at baud 
2400, no parity, 8 databits, 1 stop bit, and continuous timeout error 
retry. The second MODE command redirects output from LPT1 to the built-in 
serial port in your computer. 
If you've redirected output to COM1 or COM2 and want to return output to 
LPT1, you need to reset the MODE command using Option 1. 
Examples 
Option 1 
A»MODE LPT1:132,8 
Sets printer 1 to print 132 characters per line, 8 lines per inch. 
MS-DOS supplies the default value of no timeout error retry. This 
example also returns output to LPT1 if you've previously redirected it 
to COM1 or COM2. 
A»MODE LPT2:,,P 


Sets the retry option for timeout errors on printer 2. MS-DOS supplies 
the default values of 80 characters per line and 6 lines per inch. 


Option 2 
A»MODE CO80 


Selects the color monitor and specifies an 80-column display in color 
mode. 
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A»MODE,R 


Retains the previous display type and line length, but shifts the 
display to the right. 


A»MODE BW40,L,T 


Selects the color monitor in monochrome mode and specifies a 40-column 
display. The display is shifted 1 space to the left, and a test 
pattern is generated to check alignment. 
Option 3 
C>MODE COM1:96,E,7, 1,P 
C»MODE COM1:96,,,,P 


Both examples above initialize the COMI port at baud rate 9600, even 
parity, 7 databits, 1 stop bit, and continuous retry of timeout 
errors. In the second example, MS-DOS supplied the default values for 
the parameters replaced by commas. 

A>MODE COM1:12,,2,P 


Initializes the COM1 port at baud rate 1200. The commas after the 12 
indicate that the default values are accepted for the parity and 
databits variables. The stopbits variable is set to 2. 


Option 4 


C>MODE LPT1:=COM2 


Redirects printer output from LPT1 to communications port COM2. 
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MONO 


Purpose 
The MONO command allows you to select the monochrome monitor as the active 
display. 

Syntax 


MONO 


Type 
External 


As with all external commands, you can precede MONO with the drive and path 
on which it is located. For example: A>C:\DOS\MONO 


Comments 


The MONO command changes the input/output (1/0) address of the video 
controller, allowing you to switch from color to monochrome mode. If you 
have two monitors attached to your computer, MONO allows you to switch from 
the color to the monochrome monitor without setting the M/C switch on the 
rear panel of the computer. 

Example 
A»MONO 


Switches from the color to the monochrome monitor. To return to the 
color monitor, use the COLOR command. 


Reference 


In this chapter, you should also read about the following command: 


COLOR 
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MORE 


Purpose 


The MORE command sends output to the monitor screen one screen at a time. 


Syntax 


MORE 


Type 
External 
As with all external commands, you can precede MORE with the drive and path 
on which it is located. For example: A>C:\DOS\MORE 

Comments 
The MORE command is an MS-DOS filter (see Chapter 4 for information on 
filters). MORE displays information one screen at a time, then pauses and 


displays the following message: 


-—More-- 


When you press a key, the next screen is displayed. This process continues 
until all the data has been read. 


Because MORE is a filter, you need to use the following redirection 
symbols: 


o  Less-than sign («). 
o Pipe symbol C). 


For specific uses of these symbols with the MORE command, see Examples 
below. 


Examples 
A»DIR MORE 


A directory listing is displayed one screen at a time. 
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A»MORE «BIGF ILE. TXT 


Displays BIGFILE.TXT one screen at a time. (TYPE BIGFILE.TXT requires 
CIRL SCROLL LCK every time you want to stop and read the screen.) 


A»TYPE BIGFILE.TXT | MORE 
This also displays BIGFILE.TXT one screen at a time. Notice, however, 
that it requires more keystrokes than the previous example. 
Reference 
You'll find related information in the following chapter: 


Chapter 4 
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PATH 


Purpose 


The PATH command sets a search path in a multilevel directory structure. 


Syntax 


PATH [[d: ] path [ ; [ d: ] path ]...] 


Internal 


Comments 


When you type the name of a file, MS-DOS always looks for that file in the 
current directory. If the file isn't in the current directory and no path 
has been set, you get the message: 


Bad command or filename 


With the PATH command you tell MS-DOS to search other directories for a 
file that isn't found in the current directory. 


A path is a sequence of directory names, each separated by a backslash 
character (\). With each path you can also specify a drive. 


You can type several paths, as long as you separate them with semicolons. 
After searching the current directory, MS-DOS looks for a file in the paths 
you've named, in the order that you typed them. 


For example, if you set PATH to NARTNSALES; NDOS, MS-DOS first searches for 
a file in the current directory. If it's not there, MS-DOS searches the 
\ART\SALES subdirectory. If it’s not in \ART\SALES, then MS-DOS searches 
the \DOS subdirectory. 


The ellipsis (...) in the syntax line indicates that you can specify as 
many paths to search as you want, as long as the number of characters in 
the PATH command line doesn’t exceed 64. 
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Note: You can use the SUBSTITUTE command to shorten the length of a path 
specification. See the SUBSTITUTE command. 


PATH can be used to find only those files with a .COM, .EXE, or .BAT 
extension. 


If you type PATH by itself, MS-DOS displays the specified path. 
To erase the specified path, type: 
PATH ; 


Once you turn off the computer, the path that you specified with the PATH 
command is erased. The next time you turn on the computer, you need to 
reset the PATH command. For this reason, you may want to put a PATH 
command in an AUTOEXEC.BAT file. For more information on AUTOEXEC.BAT 
files, see Chapter 6. 


PATH does not detect an invalid path specification until MS-DOS uses it in 
a search. An invalid path is then ignored, and MS-DOS searches the next 
path specification. 


Note: You may run into character limitations on the PATH command line once 
memory resident programs like MODE and PRINT have been loaded. To avoid 
the problem, set the PATH command before you load any resident program. 
This may waste memory space, however, if you have an extremely long path 
specification. It could cause resident programs to save multiple copies of 

the environment. See the SET command for more information. 


Examples 
C>PATH \DOS; \BATCH 
When you type a filename, MS-DOS searches for the file in the current 
directory, then in the \DOS directory, and then finally in the \BATCH 
directory. 
C>PATH 


MS-DOS displays the path specification. For the previous example, 
MS-DOS would display: 


PATH=\DOS; \BATCH 
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C>PATH ; 


The path specification is erased. Typing PATH by itself to display the 
path specification would give you the following message: 


No Path 


Reference 


In this chapter, you should also read about these commands: 


In addition, you'll find related information in these chapters: 


Chapter 3, Accessing Subdirectories and Files 
Chapter 6, AUTOEXEC.BAT 
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PRINT 


Purpose 


The PRINT command lets you print a text file or list of files on your 
printer while you are working with other MS-DOS commands. This is called 
background printing. 


Syntax 


PRINT [/D:device ][/B:buffsi ze ][/Q:gueue ] 
[ d: ][ path ] £//ename [ .ext IVP IVT JVC] [...]] 


Type 
External 


As with all external commands, you can precede PRINT with the drive and 
path on which it is located. For example: A>C:\DOS\PRINT MEMO. TXT 


Comments 


Background printing allows you to print your text files while continuing to 
Work with MS-DOS in the foreground. Use the PRINT command only if you have 
a line printer connected to your computer. The first time PRINT is 

executed, it increases the memory used by MS-DOS by several thousand bytes. 


You can specify one or more files to be printed. Multiple files should be 
separated by a space or other valid delimiter. 


If only filename and extension are specified, MS-DOS assumes the default 
drive. Drive and path can be specified. Once a file has been added to the 
print queue, you can change the current directory without affecting 
background printing. 


You can use wildcard characters (* and ?) with the PRINT command. 

Files are queued for printing in the order entered on the command line. 
After each file is printed, the paper is advanced to the next page. Tabs 
are set every eight characters; any tab characters found are expanded with 


blank spaces to the next tab setting. 


Typing PRINT by itself displays the current contents of the print queue on 
your screen without affecting the queue. 
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Options 


/D:device 
Specifies the print device. If you do not specify device with the 
/D option the first time you issue the PRINT command, MS-DOS 
displays the following 
message: 


Name of list device [PRN]: 


You can enter the output device (LPT1, LPT2, LPT3, PRN, COM1, COM2, 
AUX) or press RETURN to select the default PRN. Make certain the 
device named exists and is physically connected to your computer; 
naming a nonexistent device causes unpredictable system behavior. 


Important: If you specify /D, it must be the first parameter. 


/B:buffsize 
Sets the size in bytes of the internal print buffer. The range is 
512 to 16384 bytes. If /B is not specified, the default value is 
512 bytes. Increasing the size of the buffer speeds up the PRINT 


command. 

/Q:queue 
Specifies how many print files you can have in the queue. Range is 
4 to 32 files. If /Q is not specified, the default value is 10 
files. 

/P Print mode. All files preceding the /P are added to the print 
queue. All files following the /P are also added to the print 
queue until a /C is found on the command line (see the next 
option). 

fC Cancel mode. All files preceding the /C are deleted from the print 


queue. All files following the /C are also deleted from the queue 
until a /P is found on the command line. If a file is currently 
being printed in background, printing stops and you see the 
message: 

File canceled by operator 
For example, the following commands are equivalent: 


PRINT A:1.DAT/C A:2.DAT/P A:3.DAT 
PRINT A:2.DAT/P A:3.DAT A:1.DAT/C 


Both examples add 2.DAT and 3.DAT to the queue and delete 1.DAT 
from the queue. 
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/T Terminate mode. All files presently in the print queue are 
canceled. If a file is currently being printed in background, 
printing stops and you see the message: 


All files canceled by operator 


Examples 
C»PRINT /D:LPT1 A:TEST1.DAT A:TEST2.DAT A:TESTS.DAT 


Specifies device as printer 1, places files TEST1.DAT, TEST2.DAT, and 
TEST3.DAT in the print queue, and begins printing (/P is assumed). 


C>PRINT 


Displays the contents of the print queue. If this command is issued 
immediately after the example above, MS-DOS replies: 


A:TEST1 .DAT is currently being printed 


A:TEST2 .DAT is in queue 
A:TEST3 .DAT is in queue 


C>PRINT A: TEST2.DAT/C A: TEST4.DAT/P A: TEST5.DAT 
Removes file TEST2.DAT from the print queue and adds files TEST4.DAT, 
and TESTS.DAT. If TEST2.DAT is currently printing, you see the 
message: 


File canceled by operator 


before advancing to the next page and printing the next file in the 
queue. 


C>PRINT /D:LPT2/B:512/Q:30 C: \WP\DOCUMENT \*.ASC 
Specifies printer 2, specifies a buffer size of 512 bytes, and expands 
the size of the print queue to 30 files. MS-DOS then places all files 


with a .ASC extension from the \DOCUMENT subdirectory in the print 
queue and begins printing. 
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PROMPT 


Purpose 
The PROMPT command lets you customize the characters used as the MS-DOS 
command prompt. 

Syntax 


PROMPT [string |x] 


Type 


Internal 


Comments 


Using the PROMPT command, you can change the standard MS-DOS system prompt 
to any other text you want. You can also use special characters to create 
a prompt such as the current time. 


Typing PROMPT with no parameters displays the normal prompt (the default 
drive designation and »). 


You can follow PROMPT on the command line with any string of text up to 120 
characters in length. The string is then used as the MS-DOS prompt. Both 
uppercase and lowercase characters are allowed; the string should not be 
enclosed in double quotes unless you want them to appear on-screen. 


In addition, the $x parameter can be used in the PROMPT command line to 


generate preset strings or symbols. The x should be replaced with one of 
the symbols listed in Table 5-2 below: 


Symbol Resulting Prompt 


t The current system time. 

d The current system date. 

p The current directory of the default 
drive. 

V The MS-DOS version number. 

n The default drive. 

g The » character. 
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Symbol Resulting Prompt 


l The « character. 

b The : character. 

$ The $ character. 

q The = character. 

S A space (only when followed 
by other characters). 

h A backspace and erasure of 
the previous character (see 
Examples). 


— A carriage return/line feed 
sequence (to create a new 
line). 


e The ASCII X'1B' Escape 
character (see Note below). 


Table 5-2 PROMPT Assignment Characters 


Using the PROMPT command automatically adds the specified parameters to the 
MS-DOS environment. For example, if you type SET after typing the first 
example below, the following string has been added to the environment: 


PROMPT-$p$g 


Because environment space is limited, if you enter a long string following 
PROMPT, it is possible to receive the following error message: 


Out of environment space 


This indicates that there is not enough room in the MS-DOS environment to 
accept more data. Shorten your string or restart the system and issue the 


PROMPT command before you load any memory-resident programs like MODE or 
GRAPHICS. 
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Examples 
C>PROMPT $p$g 
Sets the prompt to display the current directory. For example: 
C: \DOS> 
A>PROMPT Time = $t$_Date = $d$g 


Sets a two-line prompt (the $_ symbol creates a line break) that 
displays the current date and time. For example: 


12:34:04.21 
Wed 12-18-1985> 


Time 
Date 


The $t and $d symbols always display time and date fully as shown 
above. 


If you prefer, you can erase portions of them by following them with 
the backspace symbol ($h). For example: 


A>PROMPT Time = $t$h$h$h$h$h$h$_Date = $d$h$h$h$h$h$g 
The prompt now reads: 


Time = 12:34 
Date = Wed 12-18> 


A»PROMPT Well, what's next? 


Replaces the normal prompt with "Well, what's next?' (or any other 
humorous phrase). 


If you have loaded the extended screen and keyboard driver ANSI.SYS in your 
CONFIG.SYS file, you can use ANSI Escape sequences in the MS-DOS prompt. 
For example: 


A»PROMPT $n$g$e[7m$n$g$e[m 


Creates a standard prompt ($n$g) but sets it in reverse video mode. 
All other text remains in normal video mode. 


A»PROMPT $p$g$e[33;44m 
On a color monitor, sets the prompt to display the current directory 
($p$g) and displays the prompt in red against a blue background. For 


more information on CONFIG.SYS files, see Chapter 7. For more 
information on the ANSI.SYS driver, see Appendix A. 
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Reference 
In this chapter, you should also read about the following command: 
SET 
In addition, you'll find related information in this chapter: 


Appendix A 
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RECOVER 


Purpose 
The RECOVER command lets you recover a file with bad sectors. If a 
directory has been damaged, the contents of a floppy or fixed disk can be 
recovered. 

Syntax 
RECOVER [d: ][ path] £//ename [ .ext ] 


Or 


RECOVER d: 


Type 
External 
As with all external commands, you can precede RECOVER with the drive and 
path on which it is located. For example: A>C:\DOS\RECOVER OLDF ILE.DOC 
Comments 
If, while working with a file, you get a Bad sector message, there are two 
possible problems. Either the disk has a bad sector where the file is 
located, or the directory has a bad sector. You can use RECOVER to recover 
just one file or, if the directory is damaged, to recover all the files on 


the disk. 


When you specify a filename, the contents of that file are recovered. Note 
the following points about the RECOVER command: 


o It’s not possible to recover a portion of a file located in a bad 
sector. 


o The recovered file has the same name as the original file. 


O Bad sectors are marked, so that MS-DOS no longer stores any data in 
them. 


The drive and path tell MS-DOS where to find the filename. If they're not 
specified, MS-DOS looks on the default drive in the current directory. 


When the directory is damaged, simply specify the drive that contains the 
disk with the damaged directory. All files are recovered, including those 
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with valid directory entries. The filenames are converted to FILEnnnn.REC, 
where nnnn is a number starting with 0001. There may be extraneous data at 
the end of text files after recovery. Check and edit them if necessary. 

On a fixed disk, recovered files are placed in the root directory until 

it's full. Since the root directory may fill well before all files are 

copied, you may need to run RECOVER several times. Follow these steps to 
recover files on a fixed disk: 


1. If RECOVER stops because the root directory is full, copy the recovered 
files from the root directory to a floppy disk. 


2. Delete the files in the root directory. 
3. Run RECOVER again to recover the remaining files. 
4. Repeat steps 1-3 as needed. 


You cannot run RECOVER on a network drive. 


Example 
A»RECOVER B:MAIL.LST 
The file called MAIL.LST on Drive B is read, one sector at a time. Bad 


sectors are ignored but marked to prevent future use. The recovered 
file is named MAIL.LST. 
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RENAME or REN 


Purpose 


The RENAME command lets you change the name of a file. 


Syntax 
RENAME [d: ][ path] fi/ename[ .ext] fi/ename[ .ext ] 
or 


REN [d: ][ path] £//ename [ .ext ] f//ename[ .ext ] 


Type 


Internal 


Comments 


The RENAME command can be used to change a filename, an extension, or 
both. The command is often used to give a new and more accurate name to a 
file that has been updated. REN can be used as an abbreviation for RENAME. 


The first filename and extension refer to the file you want to rename. The 
second filename and extension stand for the new name you want to give the 


file. Wildcard characters (? and *) may be used in the filenames and 
extensions. 


The drive and path tell MS-DOS where to find the filename you want to 
rename. If they're not specified, MS-DOS looks on the default drive in the 
current directory. 
The new filename is always created on the same drive (or path) as the file 
you are renaming. You cannot transfer a file from drive to drive in the 
course of renaming it. 
Examples 

A>RENAME B:TUNES.MY HITS.MY 

Renames the file TUNES.MY on Drive B to HITS.MY 
A>REN B:\PAYABLES\MYBILLS\*.PAY *.DUE 

Refers MS-DOS to a subdirectory called \PAYABLES\MYBILLS on Drive B, 


and tells it to replace any occurrences of the .PAY extension with 
.DUE. 
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Reference 
In this chapter, you should also read about the following command: 
COPY 
In addition, you'll find related information in the following chapter: 


Chapter 1, Filenames 
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RESTORE 


Purpose 


The RESTORE command restores files backed up with the BACKUP command. 


Syntax 


RESTORE d: d:[path ][ £//ename ][ .ext llU/S lUP ] 


Type 
External 
As with all external commands, you can precede RESTORE with the drive and 
path on which it is located. For example: A>C:\DOS\RESTORE A: C: 
Comments 
Use the RESTORE command when you've made backup copies of files with the 
BACKUP command and you want to restore the files. For example, if you 
backed up all your files from a fixed disk to floppy disks, use RESTORE to 
put the files (now on floppy disks) back to the fixed disk. You can also 
restore files from: 
o A fixed disk to another fixed disk. 
o A fixed disk to a floppy disk. 
o A floppy disk to a floppy disk. 


The first parameter specifies the source drive. The source drive is the 
location of the files you want to restore. 


The second parameter specifies the target drive. The target drive is the 
destination of the files you're restoring. 


You can also specify a target path. If you don't specify a path, files are 
restored to the current directory. 


Note: If you specified a path with BACKUP, those backup files can be 
restored only to the directory they came from. If RESTORE /S doesn't find 
the right path and directory on the target drive, it creates them. 


Filename is the name of the particular file you want to restore. You can 
also use wildcards with RESTORE. For example, if you type: 


RESTORE A: C:*.DAT 


each backup file with a .DAT extension is restored to the current 
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directory. If you don't specify a filename, all the files backed up from 
the directory are restored. 


Floppy disks containing backup files should be numbered carefully, because 
files have to be restored in the order they were backed up. RESTORE 
prompts you to insert the first backup disk that contains the files you 
want to restore: 


Insert Archive Diskette O1 in Drive X: 
Press Any Key To Continue, Control-C to Abort 


Drive X is the source drive. If you have more than one backup disk, 
RESTORE asks you to insert subsequent disks as they are needed. 


Caution 


Unless you specify the /P option, RESTORE writes over any file on the 
target drive or path with the backup file that has the same name. See 
Options below. 


The RESTORE command sets exit codes as follows: 


The RESTORE program completed normally. 

No files were found to restore. 

Some files were not restored because of file sharing conflicts. 
CTRL BREAK or ESC stopped the RESTORE program. 

An error stopped the RESTORE program. 


AUC tmo 


Exit codes can be used in a batch file with the IF command. See Chapter 6. 


On a network you can restore only those files that you have access to. 
Don't use RESTORE on joined, substituted, or assigned drives. 


WARNING 


The RESTORE command may not operate as described with files backed up with 
a BACKUP program supplied by other vendors. 


Options 
/S Restores all files in all subdirectories. 


/P Prompts you for permission to restore any one of the following types of 
files: 


O Hidden files. 
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o Read-only files. 

o Files modified since the backup copy was made. (The date on the 
target file is more recert than the date on the backup, or source, 
file.) 

Examples 
C^RESTORE A: C:\ /S 


Restores all the files in all directories and subdirectories on the 
backup disk in Drive A to Drive C. 


C>RESTORE A: C:\LEVEL1\*.DAT 


Restores all the files with a .DAT extension on the backup disk in 
Drive A to \LEVEL1 on Drive C. 


CoRESTORE A: C:*.TXT/P 
Restores all the files with a .TXT extension on the backup disk in 
Drive A to the current directory on Drive C. If a file is read-only, 
hidden, or has been modified since the backup copy was made, RESTORE 
asks you for permission to restore it. 

Reference 

In this chapter, you should also read about the following command: 

BACKUP 


In addition, you'll find related information in the following chapter: 


Chapter 6, IF 
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RMDIR or RD (Remove Directory) 


Purpose 
The RMDIR command removes a directory from a multilevel directory 
structure. 
Syntax 
RMDIR [d: ] pat^ 
Or 


RD [d: ] path 


Type 


Internal 


Comments 


You use the RMDIR command to remove an empty directory. An empty directory 
has entries for the current directory and the parent directory, but has no 

files and no subdirectories. RD can be used as an abbreviation for RMDIR. 
RMDIR can be followed by either of the following: 


o A drive, to indicate the drive on which you want to remove a 
directory. Otherwise RMDIR looks on the default drive. 


o A path, to indicate where in the structure you want to remove a 
directory. 


A backslash character (M can precede path. A leading backslash 
character tells RMDIR to start at the root directory. Otherwise RMDIR 
works from the current directory. 

You cannot remove a directory if: 

o It's the root directory. 


o It’s the current directory. 


o It contains subdirectories or files, including hidden files. 
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Examples 
C>RMDIR \ART\SALES\DIV 


Removes the subdirectory called \DIV from the \ART\SALES directory. 
\DIV must be empty, or the following message is displayed: 


Invalid path, not directory, 
or directory not empty 


C>RD \ART\SALES 
Removes the subdirectory called \SALES from the \ART directory. \SALES 
must be empty before it can be removed. 
Reference 


In this chapter, you should also read about these commands: 


In addition, you'll find related information in the following chapter: 


Chapter 3, Creating a Multilevel Directory Structure 
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SELECT 


Purpose 
The SELECT command allows you to create a working copy of the MS-DOS disk 
that automatically loads a keyboard driver and date, time, currency, and 
decimal formats. 


Syntax 


SELECT xxx yy 


Type 
External 
As with all external commands, you can precede SELECT with the drive and 
path on which it is located. For example: A>C:\DOS\SELECT 044 UK 

Comments 
The SELECT command uses DISKCOPY to make a copy of your MS-DOS disk. It 
also creates two files on the copy which set the time, date, and currency 
formats, and keyboard driver when you start MS-DOS. 
The xxx parameter specifies the country code. The country code indicates 
the proper date and time format for the country selected. It also sets the 


proper currency symbol and decimal separator. 


The yy parameter specifies the keyboard code. The keyboard code indicates 
which keyboard you want to use. 


Choose the values for xxx and yy from the following table: 


Country Keyboard 
Country Code Code 
United States 001 us 
France 033 fr 
Spain 034 sp 
Italy 039 it 
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Country Keyboard 


Country Code Code 
Uni ted Kingdom 044 uk 
Germany 049 gr 


Table 5-3 SELECT Country and Keyboard Codes 
Additional country codes are listed in Chapter 7, the COUNTRY command. 


SELECT uses DISKCOPY to create a new working copy of MS-DOS and then 
DISKCOMP to verify that it is correct. Then SELECT creates a CONFIG.SYS 
file and an AUTOEXEC.BAT file on the new disk. The CONFIG.SYS file 
contains a COUNTRY-xxx command. The AUTOEXEC.BAT file contains a KEYBxx 
command which corresponds to the keyboard code you specify. For example, 
if you type IT as the keyboard code, the AUTOEXEC.BAT file will contain the 
KEYBIT command. 


The CONFIG.SYS file that SELECT creates only contains a COUNTRY-xxx 
command. If you want to include the clock driver as part of CONFIG.SYS on 
any working copy of MS-DOS, you can do one of two things: 


o Use the COPY command to append the CONFIG.SYS file on the MS-DOS Master 
disk to the CONFIG.SYS file on the working copy created by SELECT. 


Or 


o Use an editor, such as EDLIN, to edit the CONFIG.SYS file created by 
SELECT so that it includes the command: 


DEV ICEZCLKDVR.SYS 
For more information on the clock driver and the CONFIG.SYS file, see 
Chapter 7. 
Caution 
If you are running the SELECT command from a fixed disk (e.g., Drive C), 
MS-DOS assumes that the disk in Drive A contains DISKCOPY.COM and 


DISKCOMP.COM. If they are not present, an error message results. 


Also, MS-DOS expects the KEYBxx command to reside in the root directory. 
For example, if you type: 


select 044 uk 
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MS-DOS will look for KEYBUK.COM on the root directory of Drive C. If your 
MS-DOS commands are in another directory (e.g., C:\DOS), the following 
error message will appear: 


Invalid keyboard code 


You can run SELECT from your fixed disk by using the XASSIGN command to 
redirect MS-DOS to the proper directory for the DISKCOPY, DISKCOMP, and 

KEYBxx commands. In most cases, however, it is easier to run SELECT from 
your working copy of MS-DOS in Drive A. 


If you don’t use SELECT to make a working copy of the MS-DOS disk, MS-DOS 
assumes 001 as the country code and US as the keyboard code. 


Examples 


A»SELECT 033 FR 


Creates a working copy of MS-DOS specifying the French keyboard driver 
and date and time formats. 


A>SELECT 049 GR 


Creates a working copy of MS-DOS specifying the German keyboard driver 
and date and time formats. 


Reference 


In this chapter, you should also read about these commands: 


COPY 
DISKCOPY 
DISKCOMP 
KEYBxx 


In addition, you'll find related information in the following chapter: 


Chapter 2, Using SELECT 
Chapter 6, AUTOEXEC.BAT 
Chapter 7, COUNTRY 
Chapter 7, DEVICE 
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SET 


Purpose 


The SET command allows you to create a customized MS-DOS environment or to 
display the current environment. 


Syntax 


SET [string] = string2] 


Type 


Internal 


Comments 


The environment is a special buffer area in memory that contains string 
commands describing the current setup of the MS-DOS command processor (the 
COMMAND.COM program). Using the SET command, you can modify or insert 
strings in the environment to customize MS-DOS for specific applications. 


If you enter the stringl-string2 parameters, MS-DOS sets the first string 
value equal to the second string value for use in later programs. String] 

is an MS-DOS command name or a data string; string2 is the value you want 
it to equal. 


When the string parameters are inserted in the environment, any lowercase 
letters in stringl are converted to uppercase; string2 is inserted as you 
typed it. For example, if you type: 


set path=c:\data\wksheets 
MS-DOS inserts the following string in the environment: 
PATH=c: \data\wksheets 


If the name specified in stringl already exists in the environment, its 
string2 value is replaced with the new one. If no string2 value is 
specified, the name is removed from the environment. 


If you type SET by itself, MS-DOS displays the current environment. For 
example, when you start MS-DOS from Drive A, typing SET displays the 
default environment: 


PATH= 
COMSPEC=A : \COMMAND . COM 
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The COMSPEC entry is set when you start MS-DOS. It specifies the path used 
to reload the command processor when necessary. The PATH entry indicates 
that no path assignments have been specified. 


Using SET with no parameters, any program can search the environment for 
the current values. This allows you to use the SET command to define 
replaceable parameters for use in your application programs or batch 
processing files. For example, for a batch file containing the statement 
LINK %DATAFILE%, rather than manually editing the file to specify the 
DATAFILE, you can use the SET command: 


SET DATAF ILE2MAILMRGE 


to have MS-DOS substitute MAILMRGE for %DATAFILE% when you run the batch 
file. 


The SET command is most useful if your batch file contains several 
replaceable parameters. Rather than enter them on the command line every 
time you run the batch file, you can enter them once in the environment 
using SET. See Chapter 6 for more information on batch files. 


Besides SET, three additional MS-DOS commands update or insert strings in 
the environment when you use them. 


When you use COMMAND to specify a new drive and path, the COMSPEC entry is 
automatically updated. Also, using the PATH and PROMPT command inserts or 
updates the PATH and PROMPT strings in the environment buffer. 


If you use SET extensively, note the following technical information: 


o The MS-DOS environment area is normally 128 bytes. If you have not 
loaded a program (like MODE, PRINT, or GRAPHICS) that remains resident 
in memory, MS-DOS can expand the environment area. If you have 
previously loaded a program that remains resident, MS-DOS cannot expand 
the environment beyond 128 bytes. Issuing a SET, PATH, or PROMPT 
command that would cause the combined environment strings to exceed 128 
bytes will produce an error message: 


Out of environment space 


Therefore, if you need to create an environment which exceeds 128 
characters, you should do it before loading any resident programs. 


o On the other hand, because a copy of the environment is saved with 
programs that remain resident (such as MODE, PRINT, and GRAPHICS), 
loading such programs before setting your environment limits its size 
to 128 bytes but saves overall usable memory. This technique is rarely 
used, but may occasionally be helpful on systems with limited memory. 
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Examples 
C>SET COMSPEC=C: \ 


Updates the COMSPEC entry in the environment and instructs MS-DOS to 


look for COMMAND.COM in the root directory of Drive C when it has to be 
reloaded. 


C>SET PATH2C: V;C: \PROGRAMS 
Inserts a PATH string into the environment. 


C>SET CALC=C: \DATA\WKSHEETS 


Inserts the data string CALC-C:NDATANWKSHEEIS in the environment. When 
an application program like a spreadsheet is run, it can search the 
environment for the name CALC and use the specified directory for 
storing or retrieving program files. 


C>SET 


Displays the current environment. Given the examples above, MS-DOS 
would list: 


COMSPEC=C : \COMMAND . COM 
PATH=C:\;C:\DATA 
CALC2C: \DATA\WKSHEETS 


Reference 


In this chapter, you should also read about these commands: 


COMMAND 
EXIT 

PATH 
PROMPT 


In addition, you'll find related information in the following chapter: 


Chapter 6 


5-108 / MS-DOS Commands 


SHARE 


Purpose 


The SHARE command tells MS-DOS to load support for file sharing. 


Syntax 


SHARE [/F:f//espace ]l/L: /ocks ] 


Type 
External 


As with all external commands, you can precede SHARE with the drive and 
path on which it is located. For example: A>C:\DOS\SHARE 


Comments 


The SHARE command is only used when networking is active. It is included 
in an AUTOEXEC.BAT file to install shared files. 


To illustrate the way the SHARE command works, suppose several users are 
going to be working in a word processing subdirectory. Invoking SHARE 
allows more than one user to access the document files. From then on, all 
read and write requests sent to MS-DOS are checked against the file sharing 
specifications. | 


If SHARE is already loaded and you try to load it again, you see the 
message: 


Share Already Installed 


Options 


/F:filespace Entering a value with the /F option allocates file 
space in bytes for recording the names of the files 
to be shared and all necessary file sharing 
information. Each open file requires the length of 
the full filename plus 11 bytes. The default value 
is 2048 bytes. 


/L:locks An application may lock a file so that other users 
may not access or change it. The /L option tells 
MS-DOS the number of locks you want to assign. The 
default value is 20. 
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Examples 
A»SHARE 
Loads file sharing support. 
C>\DOS\SHARE /F:1000 /L:11 
Tells MS-DOS the SHARE command is in the NDOS subdirectory on Drive C, 


and that you are allocating 1000 bytes for file sharing information, as 
well as 11 locks. 
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SIZE 


Purpose 


Displays files and their sizes in bytes, as well as the disk space required 
to contain them. Use it to see whether files you are copying from a fixed 
disk to a floppy disk will fit. 


Syntax 


SIZE [[ path ][ fi /ename[ .ext l4: ]] 


Type 
External 


As with all external commands, you can precede SIZE with the drive and path 
on which it is located. For example: A>C:\DOS\S1IZE 


Comments 


The SIZE command is used to display files and their sizes in bytes. You 
can also use SIZE to tell you how much disk space is required for any 
files. 


If you type SIZE by itself, all the files on the current directory are 
listed, along with their sizes in bytes. The total number of files and the 
total number of bytes are displayed at the bottom of the list. 


You can specify a filename with SIZE. The filename is analyzed in terms of 
its size. If it isn’t located in the current directory, filename can be 
preceded by path. The filename can be followed by a target drive. If a 
target drive is specified, SIZE reports the amount of space needed on the 
disk in the target drive for filename. 


Note: There must be a disk in drive when you specify it with the SIZE 
command. SIZE determines space needs based on cluster size on the disk in 
the specified drive. 


You can use wildcard characters (? and *) with filename. 
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Examples 
C»SIZE \BIN\*.COM 


Displays a list of all the files with a .COM extension in the \BIN 
directory and their sizes in bytes. For example: 


size (c) Phoenix Software Assoc. Ltd. 1983 


chkdsk . com 6468 
diskcopy.com 2994 
format.com 7020 
comp . com 2845 


4 files, total of 19327 bytes. 
SIZE "* AS 
Displays a list of all the files in the current directory, their sizes 
in bytes, and the amount of space needed by each file on the disk in 


Drive A. For example: 


size (c) Phoenix Software Assoc. Ltd. 1983 


warped.dsk 23936 24576 
list.id 3584 4096 
first.aid 44032 44032 


3 files, total of 71552 bytes, (72704) bytes disk space required on B: 
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SORT 


Purpose 


The SORT command reads input from the standard input device (the keyboard), 
sorts it, and sends it the standard output device (the monitor screen). 
You can redirect input and output. 


Syntax 


SORT [R ][/+n ] 


Type 


External 


As with all external commands, you can precede SORT with the drive and path 
on which it is located. For example: A>C:\DOS\SORT 


Comments 


The SORT command is a filter (see Chapter 4 for information on filters). 
SORT orders data by ASCII value, lowest to highest. In general, this means 
that SORT recognizes the following order: 


O Punctuation marks. 


O Numbers. 


o Letters, uppercase and lowercase letters have equal value with SORT. 


SORT now recognizes all European variations of any given letter as equal. 


For example, all forms of the letter a have the same value as far as SORT 
is concerned. 


SORT puts numbers in the proper order as long as they are right-justified. 
A left-justified list of numbers will not be sorted correctly. For 


example, the following list would be sorted incorrectly by the SORT 
command: 


3 


10 
328 
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The proper way to list it would be: 
3 
10 
328 


Because SORT is a filter, you need to use the following redirection 
symbols: 


o  Less-than sign (<). 

o  Greater-than sign (>). 

o Pipe symbol C). 

o Double greater-than sign (»»). 


For specific uses of these symbols with the SORT command, see Examples 
below. 


Input for SORT can come from a command or a file. Output usually goes to 
the screen, but it can be redirected to a file or another device. 


Options 
/R Reverses the sort order. For example, text will be sorted Z to A. 
/+n Starts sorting with column n, where n is a number you choose. If 
you don't specify this option, SORT begins sorting on the first 
column. 
Examples 


A>DIR ! SORT/R 


The output of DIR, a list of the files on Drive A, is sent as input to 
the SORT filter. The list of filenames is sorted in reverse order and 
displayed on the screen. 


A>DIR ! SORT/+14 


The output of DIR, a list of the files on Drive A, is sent as input to 
the SORT filter. SORT starts with column 14, where the information on 
file size is kept. The list is sorted by file size, smallest file 

first. 


C>SORT «NAMES.DAT »»PHONE.LST 
SORT reads the data in NAMES.DAT, sorts it, and then appends the sorted 


list to a file called PHONE.LST. To view PHONE.LST, you'd use the TYPE 
command. 
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C^DIR SORT >LPT1 
The output of DIR, a list of the files in the current directory, is 
sent as input to the SORT filter. The list of filenames is sorted and 
sent to the printer. 
Reference 


You'll find related information in the following chapter: 


Chapter 4 
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SUBST (Substitute) 


Purpose 
The SUBST command is used to substitute a drive name for another drive, or 
another drive and path. 
Syntax 
SUBST [d: d:path ] 
or 


SUBST d: /D 


Type 
External 
As with all external commands, you can precede SUBST with the drive and 
path on which it is located. For example: A>C:\DOS\SUBST 

Comments 
SUBST uses the first parameter as a name for the second parameter. This 
command is useful when you're running an application program that allows 
you to access files only within the current directory or by a drive name. 
With SUBST a drive name can be assigned to a path, thus giving you access 


to files in different directories. 


The first parameter is a drive such as A:, B:, or C:. It has to follow 
these rules: 


O It can't be the default drive. 

o It has to be within the range of values set by the LASTDRIVE command in 
a CONFIG.SYS file. The default value for LASTDRIVE is LASTDRIVE-E. If 
you want to change it, see Chapter 7. 


The second paramter can be: 


o Any drive except the drive of the first parameter or another 
substituted drive. 


o A drive and path. The path should begin in the root directory. 
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If you type SUBST by itself, MS-DOS displays the substitutions that are 
currently in effect. 


Use the /D option when you want to delete a substitution. See Options 
below. 


You can't use SUBST on network drives. Don't use the SUBST command with 
ASSIGN. 


It is recommended that you avoid using the following commands where a 
substitution is in effect: 


ASSIGN FORMAT 
BACKUP JOIN 
DISKCOMP LABEL 


DISKCOPY RESTORE 
FDISK 


Options 


/D Deletes a drive substitution. Follow the first parameter with the /D 
option. For example: 


SUBST d: /D 


Examples 
C»SUBST E: C:\USER\FRED\FORMS 
Creates a Drive E for the path \USER\FRED\FORMS. Now you can get to 
the FORMS subdirectory simply by typing E: instead of typing the entire 
path. 
C>SUBST 


Since SUBST isn’t followed by any parameters, MS-DOS displays any 
substitution currently in effect. For example: 


E: => C:\USER\FRED\FORMS 
C>SUBST E: /D 


The /D option deletes the Drive E substitution. 
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Reference 
In this chapter, you should also read about the following command: 
XASSIGN 
In addition, you'll find related information in the following chapter: 


Chapter 7, LASTDRIVE 
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SYS 


Purpose 


The SYS command transfers the hidden MS-DOS system files to a specified 
disk. 


Syntax 


Slo d. 


Type 
External 


As with all external commands, you can precede SYS with the drive and path 
on which it is located. For example: A>C:\DOS\SYS A: 


Comments 


MS-DOS has two hidden files, IO.SYS and MSDOS.SYS, which contain the 
majority of the operating system code. These files, along with 
COMMAND.COM, must be present on any disk used to start (boot) MS-DOS. 
These disks are referred to as system disks. 


Use the SYS command to transfer a copy of the MS-DOS operating system files 
to a disk you want to use as a system disk. The SYS command does not 
transfer the COMMAND.COM file. After using the SYS command, use the COPY 
command to copy COMMAND.COM to the disk. 


When using the SYS command, you must enter the drive that contains the 
target disk. 


The target disk must be formatted and must be either empty or formatted 
using FORMAT /S or FORMAT /B to reserve directory entries for the hidden 
system files. (A system disk must contain IO.SYS and MSDOS.SYS as the 
first two directory entries. IO.SYS and MSDOS.SYS are both hidden files 
that do not appear when you execute the DIR command.) 


You cannot use the SYS command to transfer system files to a disk on a 
network drive. 


Because each version of MS-DOS is slightly different, the IO.SYS and 
MSDOS.SYS files for different versions may be different sizes. This means 
that you cannot use SYS to update system files on a disk formatted under 
previous versions of MS-DOS unless there is space for the new system files 
in the first two directory entries. 
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If MS-DOS detects a mismatch, one of the following messages will be 
displayed: 


No room for system on target disk 


There is not enough room on the target disk for the IO.SYS and 
MSDOS.SYS files. 


Incompatible system size 


The system files IO.SYS and MSDOS.SYS do not take up the same 
amount of space on the target disk as the new system. 


You can use the SYS command to transfer system files to an application 
program disk if the space required for the MS-DOS files has been allocated 
by the manufacturer. If you encounter one of the error messages above when 
trying to SYS to an application disk, use the following procedure: 


1. Format a blank disk using FORMAT /S to transfer the system files and 
COMMAND.COM. 


2. Using the COPY command, copy all of the application program files to 


the new disk. DO NOT copy the old version of COMMAND.COM, if one 
exists. 


If the application program disk is copy-protected, contact the manufacturer 
for assistance. 


Example 
A»SYS B: 


Transfers the system files from the MS-DOS disk in Drive A to the 
target disk in Drive B. 


Reference 


In this chapter, you should also read about the following command: 


FORMAT 
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TIME 


Purpose 


The TIME command displays and/or allows you to reset the time of day. 


Syntax 
TIME [^^[:mnl :ss[ .cc 1]]] 
Or 


TIME [^^[:mn[:ss [cc ]]1] 


TIME [^^[.mnl.ss[í.cc ]]]] 


TIME [AAL .mm[ .ss[,cc ]]1] 


Internal 


Comments 


Use the TIME command to set the correct time. MS-DOS uses the current time 
along with the current date to mark your files as you create or change 
them. 


The time format is determined by the country code in the CONFIG.SYS file. 
The CONFIG.SYS file is created when you use SELECT to make a working copy 
of the MS-DOS disk. See the SELECT command in this chapter or Chapter 7 
for more information on CONFIG.SYS. 


If you type the TIME command by itself, the computer displays the time from 
its internal clock and asks you to set a new time. 


Current time is hh:mm:ss.cc 
Enter new time: 


If you do not want to reset the time, press RETURN. Otherwise, type a new 
time and press RETURN. 
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You can enter a new value for the time of day simply by typing TIME and a 
value. The following rules apply to setting the time: 


o The time must be entered using numerals only and must conform to the 
24-hour system. Valid values are as follows: 


hh = 00-23 
mm = 00-59 
ss = 00-59 

cc = 00-99 


o You are required to type a value only for the hour (hh). However, if 
you enter a number only for the hour, MS-DOS assumes :00:00.00 for the 
remaining values. 


o mm stands for minutes. It isn’t required, but you should include it 
for accuracy. 


o ss stands for seconds and cc stands for hundredths of a second. 
Setting the second and hundredth-second values is optional. 


o Time value entries must be separated by colons, except that the 
hundredth-seconds entry must be separated from the seconds by a period. 


MS-DOS accepts the time entered if the values and separators are valid. If 
they are not valid, MS-DOS displays the message: 


Invalid time 
Enter new time: 


Type a valid entry for the current time and press RETURN. 


Examples 
A>TIME 14:33 
Sets the time of day to 2:33 pm. 
A>TIME 2:37 
Sets the time of day to 2:37 am. 
A>TIME 21:09:44.01 


Sets the time of day to 9:09:44.01 pm. 
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Reference 
In this chapter, you should also read about these commands: 


SELECT 
DATE 


In addition, you'll find related information in the following chapter: 


Chapter 7, COUNTRY 
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TREE 


Purpose 


The TREE command displays the paths, directories, and subdirectories on the 
specified drive. TREE can also list the files in each directory and 
subdirectory. 


Syntax 


TREE [d: IVF] 


Type 
External 
As with all external commands, you can precede TREE with the drive and path 
on which it is located. For example: A>C:\DOS\TREE 

Comments 


You can specify the drive which you want to display directories. Otherwise 
MS-DOS looks on the default drive. 


For each directory on the specified drive TREE displays: 
o The directory path, starting from the root directory. 
o The subdirectories within the directory. 


o The files in each directory, if you specify the /F option. See Options 
below. 


Note: Press CTRL S or CTRL NUM LCK to stop the scrolling of the TREE 
display. You can also view one page at a time with the MORE filter. See 
Chapter 4. 


Options 


/F Displays the filenames in each directory and subdirectory. 
Examples 


The following examples are based on the multilevel directory structure 
pictured below. 
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edlin.exe 
chkdsk .exe 











WP 


command . com 


letter1.txt 
letter2.txt 







Figure 5-5 An Example of a Multilevel Directory Structure 


C>TREE 


Displays the directories on Drive C. 


DIRECTORY PATH LISTING FOR VOLUME FIXED DISK C 


Path: \DOS 
Subdirectories: none 
Path: \DATA 


Subdirectories: WP 
ACCOUNT 


Path: \DATA\WP 
Subdirectories: none 
Path: \DATA\ACCOUNT 


Subdirectories: none 
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C>TREE/F 
Displays the directories and the files on Drive C. 
DIRECTORY PATH LISTING FOR VOLUME FIXED DISK C 
Path: \DOS 
Subdirectories: none 


Files: COMMAND . COM 
EDL IN.EXE 
CHKDSK . EXE 


Reference 


In this chapter, you should also read about these commands: 


CHDIR 
RMDIR 
MKDIR 
PATH 

XTREE 


In addition, you'll find related information in these chapters: 


Chapter 3 
Chapter 4, Filters 
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TYPE 


Purpose 


The TYPE command displays the contents of a file on the monitor screen. 


Syntax 


TYPE [d: ][ path] £//ename [ .ext ] 


Type 


Internal 


Comments 


You can use the TYPE command to view (and optionally to print) the contents 
of a file. The only formatting performed by TYPE is that tabs are set 

every eighth column. Use EDLIN (see Chapter 8) to alter the contents of a 
file. 


The TYPE command is meant to be used with text (ASCID files that can be 
displayed in readable format. Applying the command to nontext files, such 
as programs, usually results in a garbled display. 


The drive and path tell MS-DOS where to find the filename. If they're not 
specified, MS-DOS looks on the default drive in the current directory. 


You cannot use wildcard characters (* and ?) in filename. 


If the file contains more than one screen of information, the TYPE command 
causes the screen display to scroll. To freeze the screen display at any 
point, use CTRL S or CTRL NUM LCK. 


You can also use the MORE command along with TYPE to view a file one screen 
at a time. See Examples below. 


To print a file or parts of a file, you can choose among several options: 


o You can tell MS-DOS to type a particular file and stop the scrolling, 
using one of the options above. Then use SHIFT PRTSC to print only the 
contents of the screen. 


o Before issuing the TYPE command, you can turn on echo printing 
(continuous printing, line by line). There are three key combinations 
that start echo printing: CTRL PRTSC, CTRL P, and CTRL N. To 
discontinue echo printing, press the key combination again. 
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o If you want to print a long text file, you can use the PRINT command. 
This allows you to continue working with MS-DOS on other files while 
your document is printing. 

Examples 

A»TYPE B:MEMO. TXT 
Displays the file on Drive B named MEMO.TXT. 

A»TYPE NOVEL.CH6 ; MORE 


Displays the file called NOVEL.CH6, one screen at a time. 


Reference 
In this chapter, you should also read about these commands: 


MORE 
PRINT 


In addition, you'll find related information in the following chapter: 


Chapter 4 
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VDISK 


Purpose 


The VDISK command creates a virtual drive (simulated disk drive) in RAM 
(random access memory). 


Syntax 


DEVICE = [d: ][ path] VDISK.SYS [ bbb] [ sss] [ddd] 


Type 


Configuration Command 


Comments 


VDISK is not entered at the command line like other MS-DOS internal or 
external commands. It must be entered in a CONFIG.SYS file as a parameter 
of the DEVICE configuration command. This invokes the special VDISK.SYS 
device driver when you start MS-DOS. 


The VDISK.SYS driver uses a portion of memory as if it were an additional 
floppy-disk drive. A virtual drive offers faster access than floppy or 
fixed disks because it operates at the speed of memory. 


Caution 


If you are using a virtual drive to store data, you MUST copy the contents 
of the virtual drive to a physical disk drive before you turn off the 
computer. Otherwise, the data is lost when the computer shuts down. 


To use VDISK, type one or more DEVICE=VDISK.SYS commands in a CONFIG.SYS 
file using EDLIN or the COPY CON command. Then, when you start M DOS, 
each virtual drive is assigned a drive letter. 


The drive letter assigned depends upon the system configuration. For 
example, if your computer has dual floppy-disk drives (Drives A and B) and 
no fixed disk, the first virtual drive is referred to as Drive C, the 

second as Drive D, and so on. 


The CONFIG.SYS file must be in the root directory of the drive MS-DOS was 


booted from. You may specify a drive and path for VDISK.SYS, if it is not 
located in the root directory of the default drive. 
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bbb is a number specifying the size of the virtual drive in kilobytes (1024 
bytes). The default value is 64K bytes; range is 1K byte to the amount of 
memory available in your computer. 


sss specifies the sector size in bytes. The default value is 128; 
allowable values are 128, 256, or 512. 


ddd specifies the number of directory entries that the virtual disk can 
contain. The default value is 64; range is 2 to 512. 


If you specify sss, you must also specify bbb. If you specify ddd, you 
must also specify both bbb and sss. 


If an incorrect value is entered for bbb, sss, or ddd, MS-DOS supplies the 
default value. MS-DOS may adjust the value you enter to accomodate system 
limitations. For additional information on VDISK.SYS, see Chapter 7, 

DEVICE. 


Note: Each virtual drive that you create increases the amount of memory 
used by MS-DOS by the size of the virtual drive plus approximately 1K. 


Examples 
DEV!ICE=VDISK.SYS 


When you type this statement in a CONFIG.SYS file and restart MS-DOS, 
it creates a 64K byte virtual drive with the default values for sss and 
ddd. The following message is displayed: 


VDISK Version 2.0 virtual disk X: 
Buffer size: 64 KB 
Sector size: 128 
Directory entries: 64 


The X is replaced with the drive letter MS-DOS assigns to the virtual 
drive. 


DEV ICE=VDI SK .SYS 
DEV ICE=VDISK.SYS 32 128 12 


When you start MS-DOS from fixed-disk Drive C, these CONFIG.SYS 
statements create two virtual drives. Drive D has the default values 


for bbb, sss, and ddd. Drive E has a buffer size of 32K bytes, a 
sector size of 128, and a maximum of 12 directory entries. 


Reference 
You'll find related information in the following chapter: 


Chapter 7, DEVICE 
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VER (Version) 


Purpose 


The VER command displays the version number of MS-DOS currently loaded in 
the computer's memory. 
Syntax 


VER 


Type 


Internal 


Comments 
If you're working with different versions of MS-DOS, use the VER command to 
determine which level of MS-DOS you are currently using. Some MS-DOS 
commands like CHKDSK, DISKCOPY, and DISKCOMP require that disks have the 
same MS-DOS version number in order to perform the task you request. 
Example 
A»VER 


Assuming that Version 3.10 is currently loaded in memory, MS-DOS 
displays this message: 


MS-DOS Version 3.10 
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VERIFY 


Purpose 
The VERIFY command confirms that data written or copied to a disk has been 
recorded correctly. 

Syntax 


VERIFY [ ON|OFF ] 


Type 


Internal 


Comments 


VERIFY can be set either ON or OFF. Once you type VERIFY ON, the command 
remains in effect until it is turned off by typing VERIFY OFF. 


With VERIFY ON, MS-DOS will check every time information is written to a 
disk. If the data is not intact and readable, you will get an error 
message. 


If VERIFY is ON, the system runs more slowly when it is writing data to 
disks. (The verification process takes extra time.) 


If you type VERIFY by itself, MS-DOS displays the current status of the 
command (either ON or OFF). 


You can’t use VERIFY on a network drive. 
Examples 
A>VERIFY ON 
Sets VERIFY ON. 
A>VERIFY 
Asks MS-DOS whether VERIFY is ON or OFF, producing a message, such as: 
VERIFY is on 
Reference 
In this chapter, you should also read about the following command: 


COPY (/V option) 
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VOL (Volume) 


Purpose 


The VOL command displays the volume label of the disk in the default or 
specified drive. 


Syntax 


VOL [d:] 


Type 


Internal 


Comments 


You can give a disk a volume label with either FORMAT/V or LABHL. Use the 
VOL command to display a disk volume label. Use CHKDSK to display the date 
and time stamp on a volume label. 


You can specify the drive that contains the disk whose label you want 


displayed. Otherwise MS-DOS displays the volume label of the disk in the 
default drive. 


Examples . 
A»VOL 


The volume label of the disk in the default drive, Drive A, is 
displayed. For example: 


Volume in drive A is ORIGINAL WP 


If the disk in Drive A has no volume label, the following message is 
displayed: 


Volume in drive A has no label 


Reference 


In this chapter, you should also read about these commands: 


FORMAT 
LABEL 
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XASSIGN 


Purpose 


The XASSIGN command instructs MS-DOS to redirect all requests for one drive 
to a different drive. It also allows you to redirect requests for a 


specific file to a complete path specification, so that the system always 
knows where to find the file. 


Syntax 
XASSIGN [ xey  [...]]UD 1L ] 
Or 


XASSIGN [d: ] path ] - [ d: JE path VD UL ] 


Or 


XASSIGN [[ f//ename[ .ext ] - [ d: ][ path] fi /ename[ .ext ]1]U/D ]UL ] 


Type 


External 


As with all external commands, you can precede XASSIGN with the drive and 
path on which it is located. For example: A>C:\DOS\XASSIGN 


Comments 


There are three forms of the XASSIGN command. The first form redirects all 
requests for the drive specified in x to the drive specified in y. The 

second form redirects requests for the drive to a path or for one path to 
another path. The third form allows you to redirect requests for a 

specific file to the drive and path on which it is located. 


All options are primarily used with application programs designed to use 
only specific drives, such as Drives A and B, or which expect files to 
reside in a particular drive or directory. Using XASSIGN, you can redirect 
disk or file access to adapt the program to your system layout. 
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Caution 


Using the XASSIGN command considerably reduces usable memory. If your 
system's memory is limited, you may prefer to use the ASSIGN or SUBST 
commands for redirection. 


XASSIGN [ x=y [...]]VD IU/L] 


This form of XASSIGN is similar to the ASSIGN command. x is the drive 
which MS-DOS currently reads from and writes to. y is the drive you want 
MS-DOS to read from and write to. 


For example, XASSIGN A=C redirects all references to Drive A to Drive C. 
Both x and y must exist as a disk drive, a fixed-disk drive, or a virtual 
drive created using the VDISK command. 


Enter only the drive letters. Do not type the colons normally included in 
a drive name on the command line. The ellipsis (...) indicates that you 
can specify more than one x-y parameter. See Examples below. 


XASSIGN [d: ][ path ] - [d: ]L path JUD JUL ] 


The second form of XASSIGN is similar to the first, but you can use it to 
route requests for a drive to a specified drive and path. You can also 
redirect requests for one drive and path to another. 


For example, XASSIGN D=C:\DATA routes requests for Drive D to the NDATA 
directory on Drive C. XASSIGN A:\BINS=C:\BINS redirects all references to 
the \BINS directory on Drive A to the \BINS directory on the fixed disk. 


XASSIGN [[ f//ename[ .ext ]=[d: ][ path] fi /ename[ .ext ]]VD ]UL ] 


The third form of XASSIGN substitutes a complete path specification for a 
specific file. 


Some application programs (and some commands within MS-DOS) expect files to 
reside in a specific drive or directory. When the filename in the first 
parameter is requested, XASSIGN redirects the request to the drive and path 
specified in the second parameter. 


For example, when you specify the German keyboard driver with the. MS-DOS 
SELECT command, it looks for KEYBGR.COM in the root directory of the 
default drive. If the file is located in another directory (e.g., C:NDOS), 

an error message is produced. 
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Using XASSIGN, you can redirect the request for KEYBGR.COM to the proper 
directory by typing the following command before you run SELECT: 


XASSIGN KEYBGR.COM=C:\DOS\KEYBGR.COM 

Typing XASSIGN by itself resets the assignments to the default values and 
removes XASSIGN from memory. A verification message will appear. See 
Examples below. 
Note: Use XASSIGN to reassign drives only when necessary. Reassigning 
drives while using MS-DOS for normal operations can hide actual drive 
information (such as device type) from commands and programs that require 
it. 
The XASSIGN command should not be used with the BACKUP, RESTORE, FORMAT, 
LABEL, JOIN, SUBST, or PRINT commands. The DISKCOPY, and DISKCOMP commands 
ignore drive assignments. 

Options 
The following are valid options for all forms of XASSIGN: 


/D Deletes a particular assignment without affecting any other 
assignments. 


/L Displays a list of all current assignments. See Examples below. 


Examples 
C»XASSIGN A-C B-D 


Routes all requests for Drive A to Drive C and all requests for Drive B 
to Drive D. 


C»XASSIGN E=C: \UTILITY 
Redirects requests for Drive E to the \UTILITY subdirectory on Drive C. 
C»XASSIGN WP1.EXE=C: \WP\WP1.EXE 


Redirects references to WP1.EXE to the \WP directory on Drive C, 
regardless of the current directory or drive. 


C»XASSIGN B=D/D 


Deletes the assignment B=D in the first example, without affecting any 
other assignments. 
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C»XASSIGN/L 


Lists all current assignments. For example, if this command is issued 
after the previous four examples, the following is displayed: 


***** Current Assignment Table: ***** 


Requests for Path(s) Will be Routed to Path(s) 
Ei. xa. ESSE NUR OTS EE OSS WU C: 
Oe E EE E EE aa eee c:\utility 
aa- EE eR MARRE Rm ce c: \wp\wp1.exe 
C>XASS1GN 


Resets all assignments to their default values. Requests for Drive A 
go to Drive A, etc. Before the assignments are cleared, XASSIGN 
prompts: 

Erase ALL Current ASSIGNMENTS [Y/N]? : 


To erase all current assignments, type Y (for YES). 
You see the message: 


Removing XASSIGN Processor ..... 


Reference 
In this chapter, you should also read about these commands: 


ASSIGN 
SUBST 


MS-DOS Commands / 5-137 


XTREE 


Purpose 
The XTREE command displays the directories on the specified drive starting 
with the current directory and continuing down through the structure. 
Syntax 


XTREE [4: ][ £//ename [ .ext JJVA I/D ]l/Q ] 


Type 
External 


As with all external commands, you can precede XTREE with the drive and 
path on which it is located. For example: A>C:\DOS\XTREE 


Comments 


The XTREE command displays directories and subdirectories below the current 
directory. XTREE can also be used to locate specific files. 


You can specify the drive on which you want to display directories. 
Otherwise MS-DOS looks on the default drive. 


You can also specify a filename that you want to locate. XTREE displays 
that filename when it finds it in the directory structure. You can use 
wildcard characters (* and ?) with XTREE. 


Note: Press CTRL S or CTRL NUM LCK to stop the scrolling of the XTREE 


display. You can also view one page at a time with the MORE filter. See 
Chapter 4. 


Options 


/A Lists only the files that have the A (Archive) attribute set. Files 
have the Archive attribute until they're backed up. When a file is 
backed up, the Archive attribute is removed. If the file is changed 
after it’s been backed up, it is again marked with the Archive 
attribute. Programs like BACKUP use the A attribute to determine which 
files need to be backed up. 
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/D Tells XTREE to delete each file it finds. Using a wildcard, you can 
delete all .BAK files from a fixed disk with many subdirectories, 
rather than entering each directory and deleting one at a time. Make 
sure you use the /Q option with the /D option. 


/Q Used with the /D option, the /Q option causes XTREE to ask for your 
permission to delete any file it finds. Then you can check before 
deleting each file that matches a filename specified with wildcard 
characters. 


Examples 


The following examples are based on the multilevel directory structure 
pictured below. 









BIN 
edi tor .com 
letter.txt 


Figure 5-6 An Example of a Multilevel Directory Structure 


C»XTREE 


Typing the above command from the root directory displays the names of 
all directories and subdirectories. 


DOS 
BIN 
BASIC 


If you had been in the \BIN subdirectory instead of the root, XTREE 
would have listed: 


BIN 
BASIC 


XTREE works from the current directory down to the lowest level it 
finds. It does not look upward in the tree. 
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COXIMEE *.txt 


Typing the above command from the root directory displays any files 
with a .TXT extension. 


O files, O bytes 
DOS 
O files, O bytes 
BIN 

letter.txt 

1 file, 25 bytes 
BASIC 
O files, O bytes 


XTREE displays the number of files in each directory that have a .TXT 
extension, as well as the number of bytes used by those files. Files 
are listed in lowercase to distinguish them from directory names, which 
are listed in uppercase. 


C»XTREE *.TXT/D/Q 


Typing the above command from the root directory deletes any file with 
a .TXT extension. The /Q option causes MS-DOS to ask your permission 
before any file is deleted. For example: 


BIN 
letter.txt delete?(y/n) 


To delete the file, type Y (for YES). To retain the file, type N (for 
NO). 


CSXIREE *.*/AÀ 
Typing the above command from the root directory displays any files on 
Drive C that have been marked with the Archive attribute. 

Reference 

In this chapter, you should also read about these commands: 
CHDIR 
RMDIR 
MKDIR 
PATH 
TREE 


In addition, you'll find related information in these chapters: 


Chapter 3 
Chapter 4, Filters 
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CHAPTER 6 
CREATING BATCH FILES 
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ABOUT BATCH FILES 


A batch file is a sequence of MS-DOS commands that you can save in a file and 
run as a unit, just as you would run a program. Batch files must have the 
extension .BAT. 


Batch files can be quite simple or very complex. If you find yourself 
repeatedly typing the same series of MS-DOS commands, save that series of 
commands in a batch file so that you can recall them in the future by typing a 
single filename. You can even use batch files to load your application 
programs and run other batch files. 


CREATING BATCH FILES: COPY CON 


Because batch files are made up entirely of ASCII text, you can create them 
directly from your keyboard using the COPY CON (Copy from the Console) 
command. COPY CON allows you to create a batch file, but it doesn't allow you 
to correct mistakes or alter the file. If you want to modify any file created 
with COPY CON, you need to use an editor. 


The following example is a simple batch file you can create with COPY CON. It 
displays the files on the disk in Drive B in a wide format. The batch file is 
called W.BAT, and it will save you four keystrokes each time you run it. 

To create W.BAT with the COPY CON command: 

1. At the MS-DOS prompt, type: copy con w.bat and press RETURN. 

2. Type: cls and press RETURN. 


3. Type: dir b:/w and press F6. 
Pressing the F6 key, or CTRL Z, puts an end-of-file mark in the file. It 
signifies that you have finished creating your file. 


4. Press RETURN. 
The file is saved on the current drive. 


copy con w.bat 
cls 
dir b:/wZ 


1 File(s) copied 
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RUNNING BATCH FILES 


Like files with .EXE or .COM extensions, batch files (.BAT) are run by typing 
the filename without the extension. For example, to run W.BAT, type: 


W 


The screen is cleared, and the directory of the disk in Drive B is displayed in 
a wide format. 


Batch files are stopped by pressing either CTRL C or CTRL BREAK. MS-DOS asks 
your permission before it stops a batch file. 


Terminate batch file? (Y/N) 


To stop the batch file and return to the MS-DOS prompt, type Y (for YES). To 
continue the batch file, type N (for NO). 


See Chapter 5, BREAK, or Chapter 7, BREAK, for details on when MS-DOS checks to 
see if you are stopping a batch file. 

EDITING BATCH FILES: EDLIN 

You can edit and also create batch files with an editor such as EDLIN, the line 
editor supplied on your MS-DOS disk. The following example shows how to use 
EDLIN to change the W.BAT file. 

Suppose you wanted to change the W.BAT file to include CHKDSK B:, which 

verifies the integrity of the disk in Drive B before DIR B:/W displays its 

directory. 


From the disk or directory containing EDLIN: 


1. Type edlin followed by the drive, path, filename, and extension of the 
batch file to be edited. For example: 


edlin b:w.bat 


2. Press RETURN. 
You see: 


End of input file 
* 
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3. Type: 1 (for list) and press RETURN. 
This command displays a listing of the file. You see: 


"i 
isos 
2:dir b:/w 


4. Type: 2i (to insert lines before line 2) and press RETURN. 
This command puts you in the insert mode. You see: 


"2 
2: 


S. Type: chkdsk b: and press RETURN. 
You now see: 


2:*chkdsk b: 
2:9 


6. Press F6 (or CIRL C). 
You leave insert mode and return to the EDLIN command line. 


7. Type: 1 (for list) 


You see: 
=i 
1:*618 
2:chkdsk b: 
3:dir b:/w 


Notice that CHKDSK B: now precedes DIR B:/W. 


8. Type: e and press RETURN. 
This saves the new version of W.BAT on the disk. 


Now when you type W, the screen is cleared, the disk in Drive B is checked, and 

a directory of its files is displayed. You save a total of 21 keystrokes. If 

you include an external MS-DOS command like CHKDSK in a batch file, remember to 
copy the command from the MS-DOS disk onto the disk with your batch file. 


Note: See Chapter 8 for more information on EDLIN. 
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AUTOEXEC.BAT 


An AUTOEXEC.BAT file is a special type of batch file run automatically each 

time you reset the computer. Whenever you reset the computer by turning the 
power on, pressing CTRL ALT DHL, or pressing the RESET button, MS-DOS loads the 
system files and COMMAND.COM, and looks for a file called AUTOEXEC.BAT on the 
default drive. If MS-DOS finds an AUTOEXEC.BAT file, it executes each of the 
commands in the file. Whether you have a dual floppy-drive or fixed-disk 

system, AUTOEXEC.BAT can do many things automatically, such as: 


o Loading a special program each time you boot. 
o Installing some utilities. 
o Setting the MODE command to use a serial printer. 


The following example is an AUTOEXEC.BAT file you can use on a dual floppy- 
drive system. It is created with COPY CON on a bootable floppy disk. 


WIZ Loads WIZ.COM, a memory resident utility. 
MODE COM1:24,N,8, 1 Sets serial parameters. 

MODE LPT 1=COM1 Redirects parallel port to serial port. 

F I LERUN Loads FILERUN.EXE, an application program. 


Now when you boot your dual floppy-drive system, AUTOEXEC.BAT installs 
utilities and sets up the printer. Notice that MODE.COM is an external MS-DOS 
command: you must copy it from the MS-DOS disk onto the disk with your batch 


file. 

If you have an AUTOEXEC.BAT file, MS-DOS does not give you an opportunity to 
change the date or time when booting the system. If you want to set these 
every time you boot, you may include the TIME and DATE commands in an 
AUTOEXEC.BAT file. They're not necessary, however, since the Model D computer 
comes equipped with a clock/calendar and a battery backup. 

On a fixed-disk system, there are innumerable uses for an AUTOEXEC.BAT file: 

o Setting the PATH command. 

O Setting the PROMPT command to display the current directory name. 

o Setting the parameters for a serial printer. 


o Running CHKDSK to insure the integrity of your disk. 


o Installing a keyboard driver with a KEYBxx command. 
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The example below is an AUTOEXEC.BAT file for a fixed-disk system. 


PATH=\C; \DOS; WP ; \SPREAD Sets path to include frequently used directories. 


PROMPT $P$G Sets prompt to display directory name. 
MODE COM1:24,N,8, 1 Sets serial parameters. 

MODE LPT12COM1 Redirects parallel port to serial port. 
CHKDSK Verifies the integrity of the disk. 


If you have an external MS-DOS command like MODE in an AUTOEXEC.BAT file, be 
sure to include the directory where external MS-DOS commands are stored in the 
PATH command. 


BATCH FILE COMMANDS 


Using the techniques described above and your knowledge of the basic MS-DOS 
commands, you can create batch files to perform a variety of useful functions 
on your system. In addition, there are several commands to enhance the power 
of batch files. The remaining sections of this chapter discuss all the batch 
file commands. 


REPLACEABLE PARAMETERS 


In previous examples, batch files contained names of commands and files on 
which they operated. You can also create batch files as templates, to be 
completed when you run the batch. These batch files contain a symbol 
(parameter) in place of a command or filename. When you run the file, you 
identify the command, filename, or string that you want to replace the symbol 
with. 


MS-DOS uses %0-%9 as symbols that you can include in a batch file and replace 

with specific values when you run the file. Values that replace symbols can be 

MS-DOS commands, filenames (including wildcards), or strings. The 0% parameter 
always stands for the name of the batch file. The SHIFT command allows you to 
add parameters if you need more than 10. 


Syntax 


filename [%1 %2 9*3 ... € ] 


Comments 


Filename is the name you give your batch file. %1 - % are replaceable 
parameters and may appear in any order within the batch file. They may be 
filenames, commands, or strings. They are replaced with what you type on 
the command line. 
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This batch file, WOW.BAT, demonstrates the flexibility of replaceable 
parameters. 


%1 is the first replaceable parameter. %2 is the second replaceable 
parameter. %3 is the third replaceable parameter. 


Type WOW followed by any three MS-DOS commands. WOW will substitute the 
three MS-DOS commands for 901, %2, and %3. For example: 


WOW DIR CHKDSK TIME 
Or 
WOW VOL VER SIZE 


You can also use replaceable parameters to represent filenames. The first 
example in this chapter, W.BAT, displays a wide directory of all files on 
the disk. Using replaceable parameters, you can change W.BAT to display 
only the files you want. Name the new file D.BAT. 


CLS 
DIR B:%1.%2/W 


%1 and %2 refer to the filename and extension you want to search for. To 
run D.BAT, type values, separated by a space, to replace 90] and %2. For 
example, to see a directory of all batch files (files with a .BAT 

extension), type: 


D * BAT 


Notice that the period between the filename and the extension is included 
in the batch file and does not need to be typed. 


To see a directory listing of all LETTER files, type: 
D LETTER * 

The resulting display might look like this: 
LETTER. TXT 
LETTER.BAT 


LETTER.DOC 
LETTER.ASC 
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SHIFT 


Purpose 
The SHIFT command allows you to use more than 10 replaceable parameters in 
batch files. 

Syntax 


SHIFT 


Type 


Internal 


Comments 


SHIFT causes the replacement value of parameters on the command line to 
shift one position down or to the left each time it is encountered in a 
batch file. If there are more than 9 parameters on a command line, those 


appearing after the 9th (X9) are shifted one at a time into %9 by each 
successive SHIFT. 


Example 


COPY *.%1 A: 
SHIFT 
COPY *.%1 A: 


This example copies various types of files using a single replaceable 
parameter, %1. Call this batch file LOOP.BAT and run it on Drive B or C. 
If you type LOOP BAT DB the following things happen: 


o BAT is substituted for %1. All your .BAT files are copied to Drive A, 
as if you had typed COPY *.BAT A: 


O The SHIFT command removes BAT from %l and substitutes the second 


parameter, DB. Your .DB files are copied to Drive A, as if you had 
typed COPY *.DB A: 


Note: The *0 parameter always stands for the name of the batch file and is 
unaffected by SHIFT. 
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DISPLAY COMMANDS 
The display commands ECHO, PAUSE, and REMARK allow you to control the display 


of your batch file. (CLS is also a useful display command in batch files. See 
Chapter 5, the CLS command.) 


ECHO 


Purpose 
The ECHO command lets you choose whether to display the commands in your 
batch file on the screen as they are executed. 

Syntax 


ECHO [ ON|OFF ][ message ] 


Type 


Internal 


Comments 


ECHO is normally ON. It displays commands in a batch file as they are 
executed. If you enter ECHO OFF at the MS-DOS prompt or in a batch file, 
the commands are not displayed as they are executed. Any MS-DOS messages 
resulting from the commands, however, are still displayed. 


Typing ECHO by itself displays the current setting. 
Whether ECHO is set to ON or OFF, you can use message to display text. 


Message can be used only within a batch file, and it is limited to a 
maximum of 122 characters. 
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Example 


ECHO HI! 
ECHO GREETINGS! 


You can check the status of ECHO by typing ECHO by itself. If you run 
this example on Drive C when ECHO is turned on, you see: 


C>ECHO HI ! 
HI! 


C>ECHO GREETINGS! 
GREET I NGS ! 


If you run this example when ECHO is turned off, you see: 


HI! 
GREET I NGS | 


6-10 / Creating Batch Files 


PAUSE 


Purpose 


The PAUSE command stops the batch file until a key is pressed. 


Syntax 


PAUSE [ message ] 


Type 


Internal 


Comments 


Use the PAUSE command to suspend processing of a batch file. At the point 
where the PAUSE command occurs in a batch file, the batch file stops 


executing commands. It displays any optional message you've specified, 
followed by this message: 


Strike a key when ready . 


Example 


DIR. A:*.DB 


PAUSE Insert the backup disk in Drive B. 
COPY A:*.DB B:*.BAK 


This example backs up .DB files from Drive A to Drive B. First, it 
displays a directory of Drive A. The next command is PAUSE. At this point 
the batch file stops, and the following message is displayed: 


Insert the backup disk in Drive B. 
Strike a key when ready... 


When a key is pressed, the batch file continues by copying all files with a 
.DB extension on the disk in Drive A to the disk in Drive B. During the 
copying process, the extension .DB is replaced by .BAK to indicate that the 
copy is a backup of the original, as if you had typed COPY *.DB B:*.BAK. 
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REM 


Purpose 


The REM command allows you to type information in a batch file. The 
information you type will be displayed but disregarded by the computer. 


Syntax 


REM [ message ] 


Type 


Internal 


Comments 


The REM command can be used to store comments, or messages, in a file. 
These comments can be useful to someone editing a batch file later. When 
ECHO is ON, REM messages are displayed during the execution of a batch 
file. With ECHO OFF, REM messages are not displayed. The maximum length 
of a message is 123 characters. 


Example 


ECHO OFF 

REM Kathy Cork created this file on 09/06/85 
REM to format a disk, add system files, 

REM make it bootable, and check the new disk. 
REM It is called NEW.BAT. 

ECHO This file formats a disk, adds system files, 
ECHO makes it bootable, and checks the new disk. 
PAUSE Insert a new disk in Drive B. 

REM FORMAT Prepares the disk for use. 

ECHO ON 

FORMAT B:/S 

ECHO OFF 

REM DIR displays the directory. 

ECHO ON 

DIR B: 

ECHO OFF 

REM CHKDSK confirms that the disk is usable. 
ECHO ON 

CHKDSK B: 


The REM statements above are used to identify the person who wrote the 
batch file and give the date and purpose of the file. Since ECHO is turned 
OFF at the beginning, the REM statements are never displayed. When ECHO is 
off, the ECHO command is used to give messages to the user. 
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LOOPING, BRANCHING, AND CONDITIONALS 


The looping and branching commands FOR and GOTO and the conditional command IF 
provide programming-like functions. 


FOR 
Purpose 


The FOR command allows you to repeat commands in a batch file for a series 
of files. 


Syntax 
From the command line: 
FOR %variab/e IN (set )DO command 
Within a batch file: 
FOR %%variab/e IN (set )DO command 


Note: The % is necessary when you use FOR within a batch file. 


Type 


Internal 


Comments 


The variable can be any character except 0,1,2,...,9. This avoids 
confusion with the replaceable parameters %0 - %9. 


The set is a list of items separated by spaces and enclosed in 
parentheses. It may include wildcards. For example: 


(1TEM1 ITEM? ITEM3 . . . ITEM») 
Or 


(* TXT) 


When the FOR command is encountered in a batch file, the variable is 
sequentially replaced by the items contained in the set. If the set 
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includes a wildcard character (* or ?) the variable is replaced by each 


matching pattern. You can use only one wildcard item in each set. Any 
additional wildcards after the first are ignored. 


Note: You can precede the reference to a file in (set) with the drive and 
path on which it is located. For example: 


A>FOR %%Z IN (\SPREAD\*.WKS) DO DIR %%Z 


You cannot nest FOR commands within FOR commands. 


Example 


FOR %%Z IN (B:*.BAT) DO DIR %%Z>LPT1 
FOR %%C IN (B:*.BAT) DO PRINT %%C/P 


This file sends a directory of all batch files to the printer and then 
queues and prints the contents of all batch files. 


With the first FOR command, the YZ is sequentially replaced with the 
contents of the set, B:*.BAT. B:*.BAT stands for any batch files found on 
Drive B. »LPT1 redirects the output of the DIR command from the screen to 
the printer, as if you had typed the following: 


DIR B:AUTOEXEC.BAT>LPT1 
DIR B:BCKPRINT.BAT>LPT1 
DIR B:FRED.BAT>LPT1 


EIC. 


The second FOR command substitutes the same values for the set into the 
PRINT command, as if you typed the following: 


PRINT B:*.BAT/P 


Note: Because this example contains the MS-DOS PRINT command, you can use 
a variation of it to print any file that stores text in ASCII format. 
Replace the extension .BAT in lines two and three with the extension of the 


files you want to print. You can then work on other tasks while the 
printer is running. 
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GOTO 


Purpose 
The GOTO command directs your program to jump to a specified label and 
perform the commands following the label. You can only use GOTO within 
batch files and in conjunction with other commands. 


Syntax 


[IF condition ] GOTO /abe/ 


: label 


Type 


Internal 


Comments 
Each GOTO command must contain a label. The label can be any length, but 
the first eight characters must make it unique within the batch file. A 
related line tagged :label must exist in the file. 


Example 


Since GOTO is used exclusively with other commands, see the examples for 
the IF command. 
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IF 


Purpose 


The IF command lets you branch batch files. 


Syntax 


IF condition command 


Type 


Internal 


Comments 
Condition can be one of four types: 
o ERRORLEVEL 
o  string-string 
o EXIST 
o NOT 
Note: The words ERRORLEVEL, EXIST, and NOT must be uppercase. 
If the result of a condition is true, the command contained in the IF 
statement is performed before the batch file continues. If the result is 
false, the batch file continues in a normal sequence. The use of the IF 


command with each of the four conditions is described below. 


Branching can be obtained by using IF in conjunction with the GOTO command. 
IF ERRORLEVEL number command 


ERRORLEVEL responds to exit codes, which some programs generate to identify 
the nature and severity of errors that occurred while they were running. 
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ERRORLEVEL is true only if the previous program returned an exit code of 
number or higher. The only MS-DOS commands that generate exit codes that 
you can test are BACKUP and RESTORE. 


BACKUP exit code numbers: 
O The program completed normally. 
1 No files were found to back up. 
2 Some files were not backed up because of file sharing conflicts. 
3 CTRL BREAK stopped the program. 
4 An error stopped the program. 
RESTORE exit code numbers: 
O The program completed normally. 
1 No files were found to restore. 
2 Some files were not restored because of file sharing conflicts. 
3 CTRL BREAK or ESC stopped the program. 
4 An error stopped the program. 
Example 


ECHO OFF 

BACKUP \DATE\*.DB A: /M 

IF ERRORLEVEL 4 GOTO BAD 

IF ERRORLEVEL 3 GOTO STOP 

IF ERRORLEVEL 1 GOTO NOCH 

IF ERRORLEVEL O GOTO GOOD 

GOTO END 

: GOOD 

ECHO Everything went just fine. 
GOTO END 

: NOCH 

ECHO No changed databases found. 
GOTO END 

: STOP 

ECHO Program halted from keyboard. 
GOTO END 

: BAD 

ECHO Attention! An ERROR stopped the program. 
: END 
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This example uses the BACKUP command to back up the .DB files in the NDATA 
subdirectory. The IF ERRORLEVEL command is used to interpret four of the 
exit codes issued by the BACKUP command. 


ECHO is turned OFF at the beginning, so that the lines containing IF 
ERRORLEVEL are not displayed during execution of the batch file. 


When BACKUP finishes, it issues an exit code. IF ERRORLEVEL reads this 
code and compares it to number. Since IF ERRORLEVEL is true only if the 
exit code is equal to or greater than number, the IF ERRORLEVEL lines are 
listed in descending order. 


For instance, if you press CTRL BREAK while the batch file is running, 
BACKUP issues an exit code of 3. The following events occur: 


o The first IF ERRORLEVEL line asks if 3 is equal to or greater than 4. 
The answer is no, so IF ERRORLEVEL 4 is false. MS-DOS ignores the 
command GOTO BAD and reads the next line of the batch file. 


o The next line asks if 3 is equal to or greater than 3. The answer is 
yes, so IF ERRORLEVEL 3 is true. MS-DOS proceeds to the command GOTO 


STOP. 

o  :STOP displays Program halted from keyboard on the screen and then 
goes to :END. 

IF string? == string? command 


String=string is true only if stringl and string2 are identical. The 
comparison is made after you substitute replaceable parameters. Strings 
can not contain any punctuation that MS-DOS uses for other purposes. 


Example 


IF %1 == SPREADSHEET GOTO SPREAD 
IF %1 == DATABASE GOTO DATA 
IF %1 == EMAIL GOTO EMAIL 


ECHO You may select only "Spreadsheet", "Database", or "Email" for 
copying. 

GOTO END 

: SPREAD 

ECHO ON 

PAUSE Insert a spreadsheet data disk in Drive A. 
ECHO OFF 

ECHO Copying spreadsheet files to A: 

COPY *.WKS A: 

GOTO END 

:DATA 
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ECHO ON 

PAUSE Insert a database data disk in Drive A. 
ECHO OFF 

ECHO Copying database files to A: 

COPY *.DB A: 

GOTO END 

:EMAIL 

ECHO ON 

PAUSE Insert an email data disk in Drive A. 
COPY ¥ ASC A: 

: END 


This batch file, SEL.BAT, can help you sort a disK’s files into categories 
and then save each category on a separate disk. Run the batch file from a 
data disk on Drive B by typing: 


SEL [SPREADSHEET DATABASE EMAIL] 
Note the following: 
o ECHO is turned OFF, so that only relevant instructions are displayed. 
o 92 is replaced by the first parameter typed after SEL. 


o  MS-DOS compares the parameter you typed with the string variables 
entered on the IF lines. When a match occurs, the batch file goes to 
the appropriate place in the file. 


o If none of the string variables match, an on-screen message reminds the 
user which strings to type. 


For example, if you type SEL DATABASE, DATABASE is substituted for stríngl, 
the replaceable parameter %1. What you typed matches string2, DATABASE, in 
the second IF line. Since there is a string match in this case, the 

command GOTO DATA is executed, and the program jumps to :DATA. The 
commands following :DATA prompt you to insert a database disk in Drive A. 
The batch file then copies all files with a .DB extension to the disk in 

Drive A. 


If, by mistake, you type SEL WORKSHEET, there is no string match, and the 
batch file continues past the IF statements, clears the screen (CLS), and 
displays the message: 


You may currently select only ‘Spreadsheet’, ‘Database’, or ‘Email’ for 
copying. 


The batch file then ends. 
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IF EXIST [d: ][ path] filename [ .ext ] command 


IF EXIST checks whether the specified filename exists. IF EXIST is true 
only if it finds the file. Drive and path may be used to identify the 
location of the file. You can use wildcards (? and *) in the filename. 


Example 


ECHO OFF 

IF EXIST A:%1.BAK GOTO MES 

COPY %1.WKS A:%1.BAK 

ECHO A copy was made. 

GOTO END 

:MES 

ECHO This file has a backup on Drive A. 
: END 


This batch file, COP.BAT, checks Drive A for a backup copy (.BAK) of the 
specified .WKS file. For example, if you type COP EXPENSES: 


o MS-DOS replaces %1 with EXPENSES. 

o  MS-DOS checks Drive A for a file named EXPENSES.BAK. 

o If the file is found, the batch file ends after displaying the message: 
This file has a backup on Drive A. 


o If the file isn't found, MS-DOS makes a backup (COPY %1.WKS A:%1.BAK), 
and the batch file ends. 


IF NOT 


You can use NOT in conpnction with IF and the other three conditions to 
reverse the logic of a statement. 


Example 


If the above file is written using NOT, IF NOT EXIST checks Drive A for the 
specified .BAK file. If there is no .BAK copy, the command GOTO COPY is 
executed. l 


ECHO OFF 

IF NOT EXIST A:%1.BAK GOTO COPY 

ECHO This file has a backup on Drive A. 
GOTO END 

: COPY 

COPY %1.WKS A:%1.BAK 

ECHO A copy was made. 

: END 
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CHAPTER 7 
CONFIGURING YOUR SYSTEM 
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ABOUT THE CONFIGURATION FILE 

The configuration file (CONFIG.SYS) allows you to configure your system 
automatically when you start MS-DOS. The configuration file is simply an ASCII 
file that, for example, can add device drivers to your system. Each time you 
boot the system with MS-DOS, it searches the root directory of the drive it was 
booted from for a CONFIG.SYS file. If one exists, the commands specified there 
are executed. 

You can use the configuration commands in a CONFIG.SYS file to: 

o Set the BREAK command ON for extended CTRL BREAK checking. 

o Set the number of disk buffers. 

o Set the date, time, decimal, and currency format for a specific country. 


O Install specialized device drivers, including the clock driver. 


o Specify the number of files that can be opened and closed using file 
control blocks. 


o Specify the number of files that can be open at one time. 
o Set a maximum drive letter to access drives other than A through E. 


o Specify the name of a command processor other than COMMAND.COM. 


THE MS-DOS BOOT SEQUENCE 


When you boot MS-DOS, the computer reads the disk boot sector and loads the 
MS-DOS hidden system files. 


Next, a system initialization routine reads the configuration file (CONFIG.SYS) 
if it exists, and performs the commands it finds there. Finally, MS-DOS loads 
the command processor (COMMAND.COM). 


As its first task, COMMAND.COM searches the root directory of the boot drive 
for an AUTOEXEC.BAT file. If one exists, the commands found there are 
executed. If no AUTOEXEC.BAT file is present, COMMAND.COM asks the user to 
supply the current date and time. 


Note: Because the CONFIG.SYS file is executed first, no PATH, ASSIGN, or SUBST 


statements contained in the AUTOEXEC.BAT file will be recognized during 
configuration. 
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CREATING THE CONFIG.SYS FILE 


If there is no CONFIG.SYS file on the MS-DOS disk, you can use the COPY CON 
command to create one. 


Ty 


2. 


At the MS-DOS prompt (A» or C»), type: copy con config.sys 
Press RETURN. 


Type the commands you want to appear in the CONFIG.SYS file. Press RETURN 
at the end of each line. 


At the end of the last command line, press F6 and then press RETURN. 
MS-DOS exits from the COPY CON command and saves the CONFIG.SYS file on the 
default drive. 


If a CONFIG.SYS file already exists and you want to change it, you can use an 
editor such as EDLIN. 


When creating or editing a CONFIG.SYS file, remember that the commands in it 
are not executed until you restart MS-DOS. 


The following pages list the configuration commands you can use. 
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BREAK 


Purpose 


The BREAK ON command instructs MS-DOS to check for CTRL BREAK or CTRL C 
when performing any MS-DOS operation. With BREAK OFF, only input and 
output (I/O) operations are checked. 


Syntax 


BREAK ON 


Comments 


The key sequence CTRL BREAK (or CTRL C) is used to terminate many MS-DOS 
commands and application programs. If no BREAK command is present in the 
CONFIG.SYS file, MS-DOS sets the default value of BREAK to OFF. 


With BREAK set to OFF, MS-DOS checks for CTRL BREAK (or CTRL C) only when 
the system performs an operation involving the keyboard, monitor, printer, 
or standard auxillary device (such as a modem). Thus, it is difficult to 


abort a program (like a compiler) that performs infrequent device 
operations. 


With BREAK set to ON, MS-DOS checks for a CTRL BREAK (or CTRL C) entry with 
every operation. This allows you to break out of a program at any time, 
even if an error or loop is encountered. 


Reference 


You'll find related information in the following chapter: 


Chapter 5, BREAK 
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BUFFERS 


Purpose 


The BUFFERS command allows you to specify the number of disk buffers that 
are allocated in memory. 


| Syntax 


BUFFERS x 


Comments 


When MS-DOS reads from or writes to a disk, it first moves the data to a 
512-byte block of memory called a disk buffer. The disk buffer is then 
marked to indicate that it has been used recently. The next time data is 
requested, MS-DOS attempts to use a different disk buffer. When all 
buffers are filled, the data in the oldest buffer is written to disk. 


When data is requested by a program, MS-DOS checks the disk buffers for the 
data before searching for it on disk. If the data is already in a buffer, 
MS-DOS transfers it directly to the application area, thus saving time by 
avoiding disk access. 


Using the BUFFERS command in your CONFIG.SYS file, you can set the number 
of disk buffers to improve system performance. The number specified in the 
x parameter must be in the range of 1 to 99; the default value is 10. 


The optimum number of disk buffers varies widely with the type of 
application, so no firm guidelines can be given for setting the BUFFERS 
command. Programs that require little disk access or that perform 
sequential read and writes to disk may run efficiently at a lower BUFFERS 
setting. However, applications like database programs that perform 
numerous random reads and writes to disk may run more efficiently at a 
setting of 10 to 20 disk buffers. 


One additional factor to consider is memory size. Each additional buffer 

above the default value of 10 increases the amount of memory MS-DOS uses by 
528 bytes. The amount of memory available to applications is decreased 
accordingly. If your memory is limited, specifying additional buffers can 

cause some applications to run more slowly. 


The best approach is to analyze the types of application programs you use 


most often and then experiment with different BUFFERS settings until you 
achieve the best performance. 
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COUNTRY 


Purpose 


The COUNTRY command sets the proper date, time, decimal, and currency 
formats for the country code you select. 


Syntax 


COUNTRY xxx 


Comments 


If no COUNTRY command exists in the CONFIG.SYS file, MS-DOS supplies the 
U.S. value (COUNTRY-001) as a default. The date format is mm-dd-yy, the 
time format is hh:mm:ss, the decimal separator is a period (.) and the 
currency symbol is a dollar sign ($). 


By replacing the xxx parameter with a country code from the table below, 
you can set the proper formats for other countries. For example, if you 
specify COUNTRY=033, the proper date, time, decimal, and currency formats 
for France are set when you start MS-DOS. 


Country Country Code 
Australia 061 
Belgium 032 
Denmark 045 
Finland 358 
France 033 
Germany 049 
Israel 972 
Italy 039 
Nether | ands 031 
Norway 047 
Spain 034 
Sweden 046 


Switzerland 041 
United Kingdom 044 
United States 001 


Table 7-1 Country Codes 
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Note: The COUNTRY command changes only the date, time, decimal, and 
currency formats. All MS-DOS messages remain in English. 


Reference 
You'll find related information in the following chapter: 


Chapter 5, SELECT 
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DEVICE 


Purpose 


The DEVICE command allows you to specify the name of a file containing a 
device driver to be loaded in memory when you start MS-DOS. You can also 
use DEVICE to install the special ANSI.SYS and VDISK.SYS device drivers. 


Syntax 
DEVICE [d: ][ path] fi /ename[ .ext ] 
Or 
DEVICE [d: ][ path ] ANSI .SYS 
or 


DEVICE [d: ][ path] VDISK.SYS [ bbb ][ sss ][ ddd ] 


OT 


DEVICE [d: ][ path ] CLKDVR.SYS 


Comments 


Standard device drivers support the keyboard, screen, printer, floppy- and 
fixed-disk drives, and an auxiliary device (like a modem or plotter). See 
Chapter 1, Reserved Filenames, for a list of standard device drivers. You 
can use the DEVICE command to install additional device drivers. 


DEVICE [d: ][ path] £//ename [ .ext ] 


This form of the DEVICE command allows you to load drivers for specialized 
devices (such as a 3 1/2-inch disk drive). Specify the filename and 
extension of the driver file in your DEVICE command; it will be loaded into 
memory at start-up. If the file is not located in the root directory of 


the default drive, you should specify the drive and path as well. For 
example: 


DEVICE C:\DRIVERS\MICRODSK . DRV 


DEVICE [d: ][ path] ANSI.SYS 


Using this form of the DEVICE command, you can replace the standard screen 


and keyboard device drivers with the ANSI extended screen and keyboard 
control driver. 


7-8 / Configuring-Your System 


You may specify a drive and path for ANSI.SYS if it is not located in the 
root directory of the default drive. See Appendix A for further 
information on ANSI.SYS. 


DEVICE [d: ][ path ] VDISK.SYS [ 466] sss ][ ddd] 


Using this form of DEVICE, you can create a virtual drive (simulated disk 
drive) in RAM (Random Access Memory). 


The VDISK.SYS driver uses a portion of memory as a virtual drive. A 
virtual drive offers faster access than floppy or fixed disks because it 
operates at the speed of memory. 


Caution 


If you are using a virtual drive to store data, you must copy the contents 
of the virtual drive to a physical disk drive before you turn off the 
computer. Otherwise, the data is lost when the computer shuts down. 


You may type one or more DEVICE-VDISK.SYS commands in your CONFIG.SYS 
file. Then when you load MS-DOS, each virtual drive is assigned a drive 
letter. 


The drive letter assigned to a virtual drive depends upon the system 
configuration. For example, if you have a dual floppy-drive system (Drives 
A and B) and no fixed disk, the first virtual disk is referred to as Drive 
C, the second as Drive D, and so on. | 


Each virtual drive you create increases the amount of memory used by MS-DOS 
by the size of the virtual drive plus approximately 1K. 


You may specify a drive and path for VDISK.SYS if it is not located in the 
root directory of the default drive. 


You may use the VDISK.SYS variables to set the size, sector size, and 


number of directory entries of the virtual disk. The variables and their 
ranges are listed in Table 7-2 below. 
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Variable Definition Range of Values Default Value 


bb 


SSS 


ddd 


Size of drive 1K (1024 bytes) up 64K 
in kilobytes to memory limit 

Sector size 128, 256, or 512 128 

in bytes 

Number of 2 - 512 64 

directory 

entries 


Table 7-2 VDISK.SYS Variable Values 


If you use the VDISK.SYS variables, note the following technical 
information. 


O 


If an incorrect value is entered for bbb, sss, or ddd, MS-DOS supplies 
the default value. 


If you specify sss, you must also specify bbb. If you specify ddd, you 
must also specify both sss and bbb. 


If the size you specify in bbb leaves less than 64KB of usable memory, 
VDISK reduces the virtual disk size to leave 64KB available to MS-DOS. 


If the value you specify for ddd is not a multiple of the sector size, 
VDISK adjusts it upwards to the next sector boundary. For example, if 
your sector size is 128 and you specify 10 directory entries, VDISK 
generates 12 directory entries to create a multiple of the sector size. 


If you specify more directory entries than can fit in the virtual drive 
size you specified, VDISK adjusts the ddd entry downwards. 


If VDISK must adjust one of the variable values specified, a message is 
included in the VDISK startup display. For example, if you included the 
command DEVICE=VDISK.SYS 96 512 10 in your CONFIG.SYS file, VDISK would 
adjust the ddd variable from 10 to 16 when the system is restarted. The 
following message is displayed: 


VDISK Version 2.0 virtual disk D: 
Directory entries adjusted 
Buffer size: 96KB 
Sector size: 512 
Directory entries: 16 
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DEVICE [d: ][ pat^ ] CLKDVR.SYS 


This form of the DEVICE command installs a clock driver that activates the 
battery operated time-of-day clock in the Model D. 


When the CONFIG.SYS file is read, the clock driver is loaded into memory at 
address 300 to 31F hexadecimal. The clock driver is always loaded at this 
location. Make sure this doesn't conflict with anything on your system 

that seeks to use that area in memory. 


If a conflict exists, don't include CLKDVR.SYS in a CONFIG.SYS file. 
Youll then have to reset the time and date each time you boot the computer 
with MS-DOS. 
You may specify a drive and path for CLKDVR.SYS if it is not located in the 
root directory of the default drive. 

Reference 


You'l find related information in the following chapters: 


Chapter 5, VDISK 
Appendix A 
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FCBS 


Purpose 


The FCBS command allows you to specify the number of files that can be 
opened at one time using file control blocks. This command is applicable 
only when the SHARE command is loaded for file sharing. 


Syntax 


FCBS x,y 


Comments 


Some application programs use a system of file control blocks to create, 
open, close, delete, and access files. If the SHARE command is not loaded, 
there is no limit to the number of files that can be opened at one time 
using file control blocks. 


If SHARE is loaded, the x variable specifies the total number of files that 
can be open at one time using file control blocks. MS-DOS tracks the file 
control blocks as they are used. If an application program tries to open 
more than x files, MS-DOS closes the least recently used file control block 
and opens the new file. The range is 1 to 255; the default value is 4. 


The y variable specifies the number of files that MS-DOS cannot close 
automatically if a program tries to open more than x files. The first y 
files opened by file control blocks are not tracked by MS-DOS to determine 
the least recently used. Therefore, they are protected from being closed. 
The range is O to 255; the default value is O. 


The value of x should be greater than the value of y. If you set x equal 
to y, MS-DOS cannot close any file control block when a program requests 
more than x files, and thus cannot open the new file. The following 
message is displayed: 


FCB unavailable 
Abort, Retry, Ignore? 
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Example 
FCBS 7,2 
Sets a total of seven FCB files that can be open at one time. The 
first two FCB files are protected and cannot be closed by MS-DOS. 
Reference 
You'll find related information in the following chapter: 


Chapter 5, SHARE 


Configuring Your System | 7-13 


FILES 


Purpose 


The FILES command allows you to specify the number of files that can be 
opened at one time using file handles. 


Syntax 


FILES X 


Comments 


MS-DOS 3.10 uses a system of file handles to create, open, close, delete, 
and access a file. When a program tries to create or open a file, it 
passes to MS-DOS the complete path specification for the file and the 
attribute to be assigned to it. MS-DOS returns a 16-bit binary code called 
a file handle. For most subsequent operations, MS-DOS requires only this 
handle to identify the file. Application programs no longer have to 
construct their own special control block for file access. 


If no FILES command is present in the CONFIG.SYS file, MS-DOS supplies a 
default value of FILES-12. This means that no more than twelve file handles 
can be open at the same time. This setting is sufficient for most 
applications. 


If you are using an application program and receive error messages 
indicating an insufficient number of file handles, you can use the FILES 
command to specify a higher number. The range is 8 to 255. 


The value specified in x is the maximum number of file handles that can be 
open at one time for the entire system, including background tasks like 

PRINT or a network. The maximum number of file handles any one program can 
have open at one time is 20. 


Each additional file specified above the default value of 12 increases the 
amount of memory used by MS-DOS by 48 bytes. 


The FILES command does not affect the number of files that can be opened 
using file control blocks. See the FCBS command in this chapter. 
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LASTDRIVE 


Purpose 


The LASTDRIVE command allows you to set the maximum number of drives you 
can access. 
Syntax 


LASTDRIVE x 


Comments 
If no LASTDRIVE command is present in a CONFIG.SYS file, MS-DOS supplies 
the default value LASTDRIVE-E. This means that it recognizes five drive 
letters from A to E as valid, no matter how many physical drives your 
system has. 
Using the LASTDRIVE command, you can specify drive letters higher than E. 
The x parameter is a letter from A to Z. The minimum number you can 
specify is the number of physical drives installed on your computer. 
Example 
LASTDRIVE S 
Specifies A through S as valid drive letters. 
Reference 


You'll find related information in the following chapters: 


Chapter 5, JOIN 
Chapter 5, SUBST 
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SHELL 


Purpose 
The SHELL command specifies the name and location of a top-level command 


processor to be loaded in place of COMMAND.COM during MS-DOS 
initialization. 


Syntax 


SHELL [d: ][ path] f//ename[ .ext] [d: ][ path] UP] 


Comments 


The SHELL command may be used by system programmers who develop their own 
top-level command processors. In the first parameter, you should specify 

the filename and extension of the new command processor. If the file is 

not located in the root directory of the default drive, you should specify 

the drive and path as well. 


In the second parameter, specify the drive and path where the command 
processor can be found whenever it must be reloaded from disk. Use the 


second parameter only when the file specified in the first parameter is 
COMMAND.COM. 


The /P option installs the file specified in the first parameter as the 
primary command processor, so it can execute the MS-DOS EXIT command. Use 


it only when the file specified in the first parameter is COMMAND.COM. For 
more information on command processors, see Chapter 5, COMMAND. 


Examples 
SHELL C:\TESTL|IB\COMMAND.COM C:\TESTLIB /P 


Instructs MS-DOS to load COMMAND.COM from the \TESTLIB directory 
instead of the standard COMMAND.COM in the root directory. 


SHELL C: VTESTL I BYCOMPROC . COM 


Loads a customized command processor named COMPROC.COM from the 
\TESTLIB directory. 


Reference 


You'll find related information in the following chapter: 


Chapter 5, COMMAND, EXIT, SET 
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SAMPLE CONFIGURATION FILE 
A typical configuration file for a fixed-disk system might look like this: 


SHELL C: \DOS\COMMAND.COM C: DOS /P 
BUFFERS 20 

FILES 20 

BREAK ON 

DEVICE C: LANYNETWORK . SYS 
LASTDRIVE M 


This configuration file first uses a SHELL command to instruct MS-DOS to load 
COMMAND.COM from the \DOS directory of Drive C instead of the root directory. 
The C:\DOS parameter tells MS-DOS to look for COMMAND.COM in the \DOS directory 
when it needs to reload it from the disk. The /P option defines COMMAND.COM as 
the primary command processor so that it can process the MS-DOS EXIT command 
for any secondary command processors created using COMMAND. 


The BUFFERS and FILES commands are set to 20. BREAK is set to ON for extended 
CTRL BREAK checking. 


The DEVICE command loads the device driver NETWORK.SYS from the \LAN directory 


to support a Local Area Network. The LASTDRIVE command creates 13 valid drive 
letters (A-M) for use by the network. 
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ABOUT EDLIN 


In this chapter, you'll learn how to use EDLIN, the MS-DOS line editor program, 
to create, change, and display files. 


Use EDLIN for the following purposes: 

o Creating new files and saving them on disk. 

o Editing existing files. 

o  Deleting, editing, inserting, and displaying lines from a file. 
o Searching for, deleting, or replacing text within a file. 


o Saving both updated and original files. 


STARTING EDLIN 

This section describes how to create a new file and then edit it with the EDLIN 
commands. Commands are explained in greater detail later in the chapter. 
Creating an EDLIN File 


To create a file with EDLIN, type edlin and then the name you want to give 
your new file. Use the following syntax: 


EDLIN [d: ][ path] filename [ .ext ] 


Note: You can precede EDLIN with the drive and path on which it is 
located. For example: A>C:\DOS\EDLIN AUTOEXEC.BAT 


The filename must conform to the MS-DOS rules for naming files. The 
extension can be any three letter combination except .BAK. 


You can also specify a drive and path for the file. 
The following example uses EDLIN to create a file called PROGRAM.LST. 


1. At the MS-DOS prompt, type: edlin program.lst 
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2. Press RETURN. 
EDLIN displays this message: 


New file 
* 


The asterisk on the left side of the screen is the EDLIN prompt. You 
enter EDLIN commands at this prompt. 


3. Type: i (for Insert) and press RETURN. 
To begin entering text in your new file, you must type an I (Insert) 
command to insert lines. The number 1 appears, indented, followed by 
an asterisk and the cursor. 


d 


tiS 
4. Type the first line of the file and press RETURN. 


5. Type as many lines as you need to. End each line by pressing RETURN. 
For more information on inserting text, see Insert in this chapter. 


6. Press CTRL C to stop inserting lines. Or, press CTRL Z and then RETURN 
to indicate end-of-file. In either case, you are returned to the EDLIN 
prompt. 


7. To leave EDLIN, type: e (for End) and press RETURN. 


You return to the MS-DOS prompt. The new file is saved on the default 
drive. 


Editing an Existing File 
To edit an existing file, type edlin followed by the name of the file you 
want to edit. When EDLIN finds the file you specified, it loads it into 
memory. Use the following syntax: 


EDLIN [d: ][ path] filename [ .ext ] 


Note: You can precede EDLIN with the drive and path on which it is 
located. For example: A>C:\DOS\EDLIN CONF IG. SYS 


EDLIN won't accept files with a .BAK extension, because it assumes this 
extension marks a backup file. If you need to edit a file with a .BAK 
extension, you must rename it (see the RENAME command). Once the file has 
been renamed with a different extension, EDLIN will accept it for editing. 


The drive and path tell EDLIN where to find the filename. If they're not 
specified, EDLIN looks on the default drive in the current directory. 
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The following example uses EDLIN to edit PROGRAM.LST. 
1. At the MS-DOS prompt, type: edlin program.lst 


2. Press RETURN. 


When EDLIN finds the file, it loads it into memory. If the entire file 
is loaded, EDLIN displays the following message: 


End of input file 
* 


You can now edit the file using EDLIN editing commands. For example, L 
(List) displays the file 23 lines at a time and D (Delete) removes 
lines. See the editing commands in this chapter for more information. 


If the file is too large to be completely loaded into the computer's 
memory, EDLIN loads the file until memory is 75% full. In this case, 
EDLIN displays only the asterisk: 


* 


You can then edit the portion of the file in memory. After you edit 
that portion, write lines to your disk and then load the unedited 
lines. For more information on saving and loading sections of a file, 
see W (Write) and (A) Append in this chapter. 


3. To leave EDLIN, type: e (for End) and press RETURN. 

The /B Option 
EDLIN interprets a CTRL Z character as an end-of-file mark. If it 
encounters CTRL Z in a file being loaded, it stops loading the file. You 
can instruct EDLIN to ignore CTRL Z characters with the /B option. For 
example: 


EDLIN MEDICAL.DAT /B 


The /B option tells EDLIN to ignore all the CTRL Z characters within the 
MEDICAL.DAT file. 


LEAVING EDLIN 


You can leave EDLIN by typing either the E (End) command or the Q (Quit) 
command at the asterisk (*). 


o E (End) saves the current version and the last version of the file. The 
current version has the filename and extension you specified when you 


started EDLIN. The last version is given a .BAK extension. 


o Q (Quit) saves only the last version of the file and discards the current 
version. 
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LINE NUMBERS 
EDLIN displays files as a series of numbered lines, each with up to 253 
characters. Line numbers are for editing purposes only and are not saved as a 
part of the file. 
File lines are always numbered consecutively. As you add or delete lines, the 
line numbers change to reflect your actions. For example, the following file 
has 4 lines: 
1:*armadillo 
e:bird e-foot 
3:canopic jar 
4 : duck 
If you delete line 3, then line 4 is renumbered to 3: 
1:armadillo 
eibird s-foot 
3: *duck 
Current Line 
When you first open a file for editing, the current line is line 1. As you 
edit parts of the file, the current line becomes the last line edited. The 
current line has an asterisk after the line number: 
6:* The current line is marked with an asterisk. 
Unless you indicate otherwise, EDLIN commands usually apply to the current 
line of a file. 


GENERAL RULES FOR USING EDLIN COMMANDS 


EDLIN commands perform editing functions on lines of text. Read the following 
general considerations before you use EDLIN commands. 


o  EDLIN recognizes commands typed in either upper- or lowercase letters. 
o Pressing RETURN after typing a command activates it. 
o When the cursor is at the EDLIN prompt, you can enter EDLIN commands. Some 


EDLIN commands like Edit and Insert move the cursor into a file line to 
edit it. These are documented later in this chapter. 
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o The MS-DOS editing keys help you edit a file line. 


o You can type EDLIN commands with or without a space between the line number 
and command. For example, to delete line 6, the command 6d is the same as 
6 d. 


o When you type two or more consecutive line numbers, you need to separate 
them with either a comma or a space. For example, to delete lines 3 
through 6 you would type 3,6d or 3 6d. 


o You can type more than one command on a line. If any command in a line 
with multiple commands refers to a line number, the commands need to be 
separated by semi-colons. For example, to delete line 6 and then display 
lines 4 to 8, you would type 6d;4,8p. 


o You can reference line numbers relative to the current line (the line 
marked with an asterisk). Use a minus sign with a number to indicate lines 
before the current line. Use a plus sign with a number to indicate lines 
after the current line. 


For example, if you type -10,+10 1 (for List), ten lines before and after 
the current line, as well as the current line itself, are displayed. 


o You can insert a control character (such as CTRL C) in a file line by 
typing the quote character, CTRL V, before it. CTRL V tells MS-DOS to 
recognize the next uppercase letter that you type as a control character. 


You can also use CTRL V in any Search or Replace command. See the Search 
and Replace commands for more information. 


COMMAND VARIABLES 


In general, when typing EDLIN commands, follow the syntax guidelines for 
MS-DOS. The following list summarizes the variables you use with EDLIN 
commands. 


line A number that indicates a specific line number. line may be 
specified in one of three ways. 


Number. You can type any integer from 1 to 65529. Remember, if 
you type more than two consecutive line numbers in a command line, 
they need to be separated by a comma or a space. 


Period (.) The period refers to the current line, the last line 
edited. It is marked with an asterisk. 


Pound Sign (4). The pound sign tells EDLIN to change the current 
line to the line after the last line in memory. For example, if 
there are a total of 15 lines in a file and you type the pound 
sign, line 16 becomes the current line. 


8-6 / EDLIN 


n A number that indicates how many lines. You use it with the A 
(Append) and W (Write) commands. 


string A string is a group of characters that can include letters, 
numbers, spaces, and all other characters. In EDLIN, each string 
must be followed by a CTRL Z or RETURN. 

TABLE OF EDLIN COMMANDS 


Following is a list of all the EDLIN commands and what they do. 


A (Append) Reads lines of a file into memory. 

C (Copy) Copies lines. 

D (Delete) Deletes lines. 

line (Edit) Tells EDLIN which line you want to edit. 

E (End) Exits EDLIN and saves the current version of the file. 
| (Insert) Inserts lines. 

L (List) Displays the lines of a file. 

M (Move) Moves lines. 

P (Page) Pages text. 

Q (Quit) Exits EDLIN without saving the current version of the file. 
R (Replace) Replaces lines. 

S (Search) Searches for the specified string. 

T (Transfer) Transfers text. 

W (Write) Writes lines of a file in memory to a disk. 
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A. (Append) 


Purpose 
Adds the specified number of lines to the file being edited in memory. The 


lines are read from the disk that holds the file. They are then added 
below the lines currently in memory. 


Syntax 


[n]A 


Comments 


This command is meaningful only if the file being edited is too large to 

fit into memory. When you start EDLIN, lines are read into memory until 
memory is 75% full. To edit the remainder of the file, you must write some 
of the edited lines that are in memory to the disk (see the Write 
command). Then you can load the unedited lines from the disk into memory 
by using the Append command. 


n tells EDLIN how many lines to append. If you don’t specify n, lines are 
appended to the file in memory until memory is 75% full. If available 
memory is already 75% full, no action is taken. 


When the Append command has read the last line of the file into memory, you 
see the message: 


End of input file 


Example 
*12A 


Twelve lines are read from the disk and added to the end of the file in 
memory. 
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C (Copy) 


Purpose 


Copies a range of lines to a specified line number. The lines can be 
copied as many times as you want. 


Syntax 


[ //nel,[/ine],//ne[ ,count ]C 


Comments 


You can specify three line numbers with Copy. Use the first and second 
lines to indicate the range of lines you want to copy. The first line 
tells EDLIN " start copying at this line The second line tells EDLIN 

" copy up to and including this line. The third line is the target line. 
It tells EDLIN " put the copied lines here. If the first or the second 
line is omitted, the default is the current line. 


Count tells EDLIN how many times to copy the specified range of lines. If 
you do not specify count, EDLIN copies the lines once. 


Lines are renumbered automatically after a copy. The target line becomes 
the current line. 


The line numbers in a Copy command must not overlap (the third /ine has a 
lower number than the second line). If they do, you see the message: 


Entry error 


Examples 
*1;3,4C 


Copies lines 1 through 3 and starts copying them at line 4. For 
example, the file: 


1:aa 
2: DD 
Sie 


is changed to: 


:aa 
: bb 
CC 
: *aa 
: bb 
rf ©) 


OONAN- 
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*1,3,4C 


Copies lines 1 to 3 and starts copying them at line 4 within the file. 
For example, this file: 


1:Red is the rose 

2:Green is the fern. 
3:MS-DOS is easy to learn. 
4: Why do | sit here 
5:Writing this junk? 
6:l've got to go 

7:And feed my pet skunk. 


becomes: 

1:Red is the rose 

2:Green is the fern. 
3:MS-DOS is easy to learn. 
4:*Red is the rose 
5:Green is the fern. 
6:MS-DOS is easy to learn. 
7:Why do | sit here 
8:Writing this junk? 


9:l've got to go 
10:And feed my pet skunk. 


*lgosdu 


Copies lines 1 through the current line and places the copy at line 5. 
Three copies are made of the specified range. 


In the following example, the current line is line 1. 


1:*Red is my nose. 

2:Blue are my toes. 

3:My teeth start to chatter 
4:Whenever it snows. 


Therefore, when the above command is typed, only line 1 is copied three 
times. 


:Red is my nose. 

:Blue are my toes. 

:My teeth start to chatter 
: Whenever it snows. 

:*Red is my nose. 

:Red is my nose. 

:Red is my nose. 


NOOO AUN — 
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D (Delete) 


Purpose 


Deletes a specified range of lines in a file. 


Syntax 


[ /ine ]L , / /ne ]D 


Comments 


To delete a single line, you only need to specify the first line. 


To delete a range of lines that starts with the current line, you only need 
to specify the second line. 


To delete any range of lines, you need to specify the first and second 
lines. The first line tells EDLIN " start deleting at this line. The 
second line tells EDLIN "delete up to and including this line.’ 


Lines are renumbered automatically after a deletion. The line immediately 
after the deleted section becomes the current line. 


Examples 
"E 


Deletes a single line, line 2. For example, the file: 


1:aa 
2:bb 
Sice 


would be changed to: 


1:aa 
2:766 


* , 4D 


Deletes a range of lines that starts with the current line and ends 
with line 4. The file: 


1:Dear Bob, 
2:How are you? 
3:*Line 3 is the current line. 


4:Notice that the current line has an asterisk. 
5:| am fine. 
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is changed to: 


1:Dear Bob, 
2:How are you? 
3:*| am fine. 


*9,9D 


Deletes a range of lines that starts with line 3 and ends with line 5. 
For example, the file: 


1:*Take a frying pan and put it on the stove. 
2:Put some butter in the pan. 

3:Turn the heat under the pan to medium high. 
4:Break an egg on the side of the pan. 

5:Put the egg in the pan. 

6:Fry it until it's cooked the way you like it. 


becomes: 
1:Take a frying pan and put it on the stove. 


2:Put some butter in the pan. 
3:*Fry it until it's cooked the way you like it. 
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E (End) 


Purpose 


Ends the editing session and saves the current version of the file. 


Syntax 


E 


Comments 
This command saves the edited file on disk, gives a .BAK extension to the 
original version of the file, and then exits EDLIN. If the file was 
created during the editing session, no .BAK file is created. 
The file is saved on the disk in the drive you indicated when you began 
editing. If you didn't type a drive name, the file is saved on the default 
drive. 
You must be sure that the disk contains enough free space for the entire 
file. If there isn't enough space on the disk, the write is aborted and 
the edited file is lost, although part may be written on the disk. 


See the Quit command in this chapter for more information. 


Example 
"E 


After you press RETURN, the editing session ends. The MS-DOS prompt is 
displayed. 
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Edit 


Purpose 


Edits a line in a file. 


Syntax 


[ /ine ] 


Comments 


When you want to edit a specific line in a file, use the Edit command. You 
can tell EDLIN which line you want to edit by one of the following means: 


o Typing a number. 

o Typing a period. 

o Pressing RETURN. 

When you type a line number, EDLIN displays the number and the contents of 
the line. Then, on the line below, EDLIN reprints the line number. The 

line is now ready for editing. You can use any of the MS-DOS editing keys 
to edit the line. The existing line serves as the template. 


If you type a period (.), the current line is displayed for editing. 


If you press RETURN, the line after the current line is displayed for 
editing. 


In any case, once a line is displayed, you can press RETURN to leave it as 
it is. 
WARNING 


If you press RETURN while the cursor is in the middle of the line, the 
remainder of the line is deleted. 
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Example 
*4 


Edits line 4 in a file. The contents of the line are displayed. For 
example: 


4:*This line needs editing. 
4:* 


You may now edit the line and press RETURN, or press RETURN to leave 
the line as it is. 
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I (nsert) 


Purpose 


Inserts text. 


Syntax 


[ /ine ] | 


Comments 
Use the Insert command to: 
o Type text when you are creating a new file. Text begins with line 
number 1. Successive line numbers appear automatically each time you 


press RETURN. 


o Insert text before the specified line in an existing file. If line is 
not specified, the current line is assumed. 


Lines are renumbered automatically after an insertion. The line 
immediately following the inserted line becomes the current line. 


If line is any number larger than the last line number, or if a pound sign 
(#) is specified, the inserted lines are appended to the end of the file. 
In this case, the last line inserted becomes the current line. 


To leave insert mode, press CTRL C. 


Examples 


e 


Allows you to type text in a newly created file, or inserts lines in an 
existing file immediately before the current line. 


"3 
Inserts lines beginning at line 3. 
dit 


Type the text for line 3 and press RETURN. Press CTRL C to leave 
insert mode. 


3:*This wasn't here before. 
Acc 


Line numbers are adjusted to reflect the insertion. 
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L (List) 


Purpose 


Use the List command to display the contents of a file. 


Syntax 


[ //ne ]L , / /ne JL 


Comments 


The List command displays a range of lines beginning with the first line 
and ending with the second line specified. 


If you specify only the first line, List displays 23 lines, beginning with 
line. 


If you specify only the second /ine, List begins the display 11 lines 
before the current line and ends it at line. If line is more than 11 lines 


before the current line, the display will be the same as if you had omitted 
both options. 


If you type L by itself, List displays 11 lines before and after the 


current line, as well as the current line. If there aren't 11 lines before 
or after the current line, then enough lines are displayed to total 23. 


Examples 
Jim. s 


Displays lines 1 to 3. 


*3L 
Displays 23 lines, starting with line 3. 

* eol. 
Starts the display 11 lines before the current line and stops at line 
28. 

*L 


Displays 11 lines before and after the current line, as well as the 
current line. 
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M (Move) 


Purpose 


Moves a block of text to the specified line. 


Syntax 


[ //nel,[//ne],//ne M 


Comments 


Use the Move command to move a block of text to another location in the 
file. 

You can specify three line numbers with Move. Specify the range of lines 
you want moved with the first and second lines. The first line tells 
EDLIN, " Start the move at this line." The second line tells EDLIN, "Go up 
to and include this line." The third line is the target line, above which 
text is inserted. If you omit the first or second line, the default is the 
current line. 

Lines are renumbered automatically after a move. 


The line numbers in a Move command must not overlap (the second line has a 
lower number than the first line). If they do, you see the message: 


Entry error 
You can use a plus (+) or a minus (-) sign with either the first or second 


line, as long as the sign doesn’t cause line numbers to overlap. See 
examples below. 


Examples 
*22,31, 100M 
Moves a block of text, consisting of lines 22 to 31, to line 100. 
* +25, 100M 


Moves a block of text, made up of the current line plus the 25 lines 
that follow it, to line 100. 
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P (Page) 


Purpose 


Pages through a file 23 lines at a time. 


Syntax 


[ //ne ]L[ , / /ne ] P 


Comments 


If you specify the first line, the Page command displays 23 lines, starting 
with the line specified. 


If you specify the first and second lines, the Page command displays a 
range of lines starting with the first line and ending with the second 
line. 


If you type P by itself, the Page command displays 23 lines, starting with 
the line after the current line. 


If you specify only the second line, you see the message: 


Error entry 


Example 
“ZOypoer 


Displays lines 25 to 32. 
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Q (Quit) 


Purpose 


Quits the editing session without saving any of the editing changes just 
made. 


Syntax 


Q 


Comments 
When you type Q and press RETURN, EDLIN displays the message: 
Abort edit (Y/N)? 
If you want to quit the editing session, type Y. No editing changes are 
saved and no .BAK file is created. If you want to continue the editing 


session, press any key. 


See the End command in this chapter for more information. 


Example 
*Q 
After you press RETURN, the following message is displayed: 
Abort edit (Y/N)? 


If you type Y, EDLIN ends, the current version of the file is not 


saved, and you return to the operating system, with the MS-DOS prompt 
displayed. 


8-20 / EDLIN 


R (Replace) 


Purpose 


Within the specified range, replaces all occurrences of a string of text 
with a different string of text (or blanks). 


Syntax 


[ //ne ]L ,/ine ][ ? JR [ string? ][ CIRL Z string2 ] 


Comments 


To activate the Replace command, you must press RETURN or CTRL Z after 
string2. As each occurrence of stringl is found, it is replaced by 

string2. Each line in which a replacement occurs is displayed. If a line 
contains two or more replacements, then the line is displayed once for each 
occurrence. When all the replacements have been made, the Replace command 
ends and the asterisk prompt reappears. 


You can specify the range of lines on which you want the Replace command to 
operate. The first line tells EDLIN, " Start the operation at this line.’ 

If the first line is omitted, the line after the current line is the 

default. 


The second line tells EDLIN, "End the operation at this line." If the 
second line is omitted, the line after the last in the file is the default 
line (as if you had typed #). 


Specify the string you want to replace with stringl. Specify the 
replacement text with string2. stringl and string2 must be separated by 
CTRL Z. 


If string1l is omitted, then Replace takes the stringl specified in a 
previous Replace command. If there isn't a previous stringl, the Replace 
command ends. 


If you press CTRL Z after stringl, but don't specify a string2, EDLIN 
assumes you want to replace stringl with blank spaces. 


If you press RETURN after stringl, but don't specify a string2, a previous 
string2 is used as the replacement. 


If you want to use a control character for either stringl or string2, 
precede it with CTRL V. For example, to specify CTRL Z as stringl, you 
would press CTRL V and then type Z. 


Note: EDLIN allows you to type more than one command on a line. You can 
include a Replace command on a multiple command line by typing CTRL Z after 
string2. 
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Options 
? If the ? option is used, the Replace command stops at each line with a 
string that matches stringl and shows you what the line looks like when 


stringl is replaced with string2. You are then prompted with the 
message: 


O.K.7 


To confirm the replacement, type Y or press RETURN. The Replace 
command continues. 


To prevent the replacement, press any key. The Replace command leaves 


the line as it was originally and continues. Use this option to 
prevent unwanted substitutions when stringl occurs more than once. 


Examples 


*1,RMICHAEL CTRL Z ALAN 


Searches from line 1 to the end of the file for the string MICHAHL. 
Whenever it is found, it is replaced with the string ALAN. 


*4,10?R CTRL Z 


Searches lines 4 to 10 for a previous stringl and replaces it with 
blank spaces. 
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S (Search) 


Purpose 


Searches a range of lines for a string of text. 


Syntax 


[ /ine ]L ,/ine JL? 1S [ string] 


Comments 


To activate the Search command, you must press RETURN or CTRL Z after 
string. The Search command searches for the specified string. The first 

line that matches string is displayed and becomes the current line. The 
Search command ends when the first match is found, unless you specify the ? 
option (see Options below). If no line contains a match for string, you 

see the message: 


Not found 


You can specify the range of lines you want to search with the first and 
second lines. The first line tells EDLIN, " Start the search at this 

line." If the first line is omitted, the line after the current line is 

the default. 


The second line tells EDLIN, " End the search at this line If the second 
line is omitted, the line after the last in the file is the default line 
(as if you had typed 4$). 


If string is omitted, Search takes the string specified in a previous 
Search or Replace command (if there is one). If there isn't a previous 
string, the Search command ends. 


If you want to search for a control character in a file, use CTRL V. For 


example, to specify CTRL Z as string, you would press CTRL V and then type 
Z. 


Note: To include a Search command on a multiple command line, press CTRL Z 
after string. 
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Options 
? If the ? option is included in a Search command, EDLIN displays the 


first line with a matching string. You are then prompted with the 
message: 


O.K.? 


To stop the search, press RETURN or type Y. To continue the search, 
press any key. The process is repeated until all lines have been 
searched, or until you press RETURN or type Y. 


Examples 
*3, 407TSIF 
Searches lines 3 to 40 for the string IF. Because the ? option is 
included, when the first occurrence of IF is found, the following 
message is displayed: 


O.K.? 


To continue the search, press any key. To end the search, type Y or 
press RETURN. 


*4, SECHO 


The second line isn't specified, so the default value, the line after 
the last line of the file, is used. The search looks from line 4 to 


the end of the file for the string ECHO. The search ends when the 
first occurrence is found. 
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T (Transfer) 


Purpose 
Inserts the contents of the specified file into the file currently being 
edited. 

Syntax 


[ //ne]lT[d4: ][ path] filename [ .ext ] 


Comments 
The Transfer command can merge the contents of two files. The contents of 
the filename you specify are inserted into the file currently in memory. 
The drive and path tell EDLIN where to find the file you want to transfer. 
Otherwise, EDLIN looks for it on the default drive in the current 
directory. 


The transferred text is inserted at line. If you don't specify line, the 
default is the current line. 


Lines are renumbered automatically after a transfer. 


Example 
*13T\ALPHA\BET .L ST 


The contents of the file called BET.LST, located in the NALPHA 
subdirectory, are inserted at line 13 of the file currently in memory. 
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W (Write) 


Purpose 


Writes a specified number of lines to disk from the file being edited in 
memory. Lines are written to disk beginning with line 1. 


Syntax 


[5]W 


Comments 


This command is meaningful only if the file being edited is too large to 

fit into memory. When you start EDLIN, lines are read into memory until 
memory is 75% full. To edit the remainder of your file, you must write 
some of the edited lines in memory to disk. Then you can load the unedited 
lines from the disk into memory using the Append command. 


n tells EDLIN how many lines to write to disk. If you don't specify n, 
lines are written to disk until memory goes back down to 75% full. If 
memory is only 75% full at the time, no action is taken. 


All lines in memory are renumbered automatically after a Write command is 
issued. 


Examples 
TEN 


Twelve lines, beginning with line 1, are written to disk. 
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ERROR MESSAGES 


Cannot edit .BAK file —-- rename file 
You attempted to edit a file with a filename extension of .BAK. .BAK files 
cannot be edited, because EDLIN reserves this extension for backup copies. 


If you need to edit a file with an extension of .BAK, you must either 
rename the file with a different extension, or copy the .BAK file and give 
it a different filename extension. 


Disk full. Edits lost. 
EDLIN was not able to save your file due to lack of disk space. The End 
command is aborted and you are returned to the operating system. The file 
has been lost. Always be sure that the disk has sufficient free space for 
the file before you begin your editing session. 


Disk full -- file write not completed 
You issued the End command, but the disk did not contain enough free space 
for the whole file. EDLIN aborts the End command and returns you to the 
operating system. 


Only a portion (if any) of the file has been saved. The rest of the file 
has been lost. You should delete any saved portion of the file and restart 
the editing session. Check for sufficient disk space before editing. 


Entry error 
The last command you typed contained an error. Retype the command with the 
correct syntax and press RETURN. 


File creation error 
The EDLIN temporary file cannot be created. Check to make sure that the 
directory has enough space to create the temporary file. Also, make sure 
that the file does not have the same name as a subdirectory in its 
directory. | 


File is READ-ONLY 
The file cannot be written to. Use the ATTRIB or CHMOD command to change 
the file to read-write. 


File not found 
EDLIN could not find the filename you typed with a Transfer command. Type 
a valid filename when issuing a Transfer command. 


Filename must be specified 


You did not specify a filename when you started EDLIN. Type EDLIN and then 
a filename. 
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Incorrect DOS version 


You attempted to run EDLIN under a version of MS-DOS that was not 2.0 or 


higher. You must make sure that the version of MS-DOS you are using is 2.0 
or higher. 


Insufficient memory 
There is not enough memory to run EDLIN. You must free some memory. 


Invalid drive or file name 


You did not specify a valid drive or filename when you started EDLIN. Type 
a correct drive or filename. 


Invalid parameter 


You specified an invalid option when you started EDLIN. EDLIN recognizes 
only the /B option. 


Line too long 


During a Replace command, the string given as the replacement caused the 
line to expand beyond the limit of 253 characters. EDLIN ended the Replace 


command. Divide the long line into two lines, and then try the Replace 
command again. 


Must specify destination line number 


A destination line number was not specified for a Copy or Move command. 
Retype the command with a destination line number. 


No room in directory for file 


When you tried to create a new file, either the directory was full, or you 
specified an illegal disk drive or an illegal filename. 


Check the command line that started EDLIN for an illegal filename or 
illegal disk drive entry. If your command contains no illegal entries, run 
the CHKDSK program on the specified disk. If the status report shows that 
the disk directory is full, remove the disk. Insert and format a new disk. 


Not enough room to merge the entire file 


There was not enough room in memory to hold the file during a Transfer 
command. You must free some memory. 


Not found 


EDLIN was unable to find an occurrence of the string specified in a Search 
or Replace command. 


PM E. 


This message appears when you include the ? option with either a Search or 
a Replace command. 
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ABOUT MS-LINK 


This chapter describes MS-LINK. It is recommended that you read the entire 
chapter before you use MS-LINK. 


Note: If you are not going to compile and link programs, you do not need to 
read this chapter. 


The MS-DOS linker (called MS-LINK) is a program that: 


o Combines separately-produced object modules into one relocatable load 
module -- a program you can run. 


o Searches up to eight library files for definitions of unresolved external 
references. 


O Resolves external cross-references. 


o Produces a listing that shows resolved external references and error 
messages. 


A program is originally written in source code. This source code is passed 
through a compiler that produces object modules. The object modules must be 
passed through the link process to produce machine language that the computer 
can understand to run the program. 


You may want to link (combine) several programs to run them together. Each 
object module may refer to a symbol that is defined in another object module 
linked to it. This is called an external reference. 


MS-LINK combines several object modules into one relocatable load module called 
a Run File. The Run File is an executable file, with an .EXE extension. As it 
combines modules, MS-LINK makes sure that all external references between 
object modules are defined. MS-LINK can search up to eight Library Files for 
definitions of any external references not defined in the object modules. 


MS-LINK also produces a printable List File that shows resolved external 
references and displays error messages. 


MS-LINK uses available memory until it is exhausted. Then MS-LINK creates a 
Temporary File named VM.TMP. 
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Figure 9-1 below illustrates the various parts of the MS-LINK operation. 


Non-Assemblv 
Source 
.OBJ .OBJ .OBJ .OBJ 


libraries listing 
.LIB ESE 


Up to 8 libraries PUBLIC symbols 
can be searched cross-referenced 


" Run file 
Used only if Run file VM.TMP 
is larger than memory — 












MS-LINK 


Figure 9-1 The MS-LINK Operation 


DEFINITIONS FOR ASSEMBLY-LANGUAGE PROGRAMMERS 


Some of the terms used in this chapter are explained below to help you 
understand how MS-LINK works. Generally, if you are linking object modules 
compiled from GWBASIC, PASCAL, or another high-level language, you don’t need 
to know these terms. If you are writing and compiling programs in assembly 


language, however, you need to understand how MS-LINK divides memory into 
segments, classes, and groups. 


o A segment is a contiguous area of memory, up to a maximum length of 64K 
bytes. It may be located on a paragraph (16-byte) boundary anywhere in 
memory. Each segment has a segment name and a class name. 


o A class is a collection of segments. The assigning of segments to a class 
controls the order and relative placement of segments in memory. 


o A group is a collection of segments that fit within a 64K area of memory. 
The segments do not need to be contiguous to form a group (see Figure 
9 2). The address of any group is the lowest address used by any segment 
in that group. MS-LINK analyzes the groups, then references segments by 
the group address. A program may consist of one or more groups. 
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If you are writing in assembly language, you may assign the group and class 
names in your program. In high-level languages (like GWBASIC, COBOL, FORTRAN, 
and PASCAL), the naming is done automatically by the compiler. 

MS-LINK loads all segments into memory by class name, from the first segment 
encountered to the last. All segments assigned to the same class are loaded 
into memory contiguously. 


In Figure 9-2, three segments that fall into one group have been shaded to 
illustrate these concepts. Table 9-1 shows how class names may overlap 


segments. 
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Figure 9-2 Memory Divided into Segments 









Memory 






Segment Segment Name Class Name 
Segment 1 PROG.1 CODE 
Segment 2 PROG.2 CODE 
Segment 12 PROG.3 DATA 


Table 9-1 Sample Segment and Class Names 


Note that segments 1 and 2 have different segment names but have the same 
segment class name. When MS-LINK loaded the segments into memory, it loaded 
them by class, so PROG.1 and PROG.2, having the same class name CODE, were 
loaded as contiguous segments 1 and 2. PROG.3 was loaded as segment 12, 
contiguous with other segments with the class name DATA. 
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Segments 1, 2, and 12, although they are not contiguous, also form a group of 
segments that fit within a 64K-byte block of memory. The group address is the 
lowest address of segment 1 (i.e., the lowest address of the group in memory). 


MS-LINK COMMAND SYNTAX 


When you start a linker session, you must reply to a series of four prompts. 
You can reply to these MS-LINK prompts three different ways: 


o By entering a response to each prompt at the keyboard. 


o By entering your responses to all four prompts at the command line when you 
start MS-LINK. 


o By using an automatic response file to supply MS-LINK with the responses. 
See Starting MS-LINK in this chapter for more information on each method. 
Whichever method you choose, you enter the same three types of information in 
response to each MS-LINK prompt: file specifications, command characters, and 
command options. 


MS-LINK FILE SPECIFICATIONS 


Once you start a linker session, MS-LINK prompts you to specify four types of 
files: 


o One or more Object Modules (input files). 

o One Run File (executable output file). 

o One List File (optional external reference file). 

o Up to eight Library Files (to be searched for external references). 


For each type of file, you may specify a four-part file specification. The 
format for MS-LINK file specifications is the same as that of a disk file: 


[d: ][ path] filename [ .ext ] 
If you do not enter a drive and path, the default drive and path are assumed. 
Allowable drive letters for MS-LINK are A through O; the colon (:) is always 


required as part of the drive designation. 


For each file specified, you must supply a valid filename. The extension, if 
one exists, is one- to three-characters, always preceded by a period. 
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If no filename extensions are given in the file specifications, MS-LINK 
supplies default extensions. They are listed below in Table 9-2. You can 
override all of the defaults except .EXE. 


Type of File Default Extension Can You Override? 


Object Modules .OBJ YES 
Run File .EXE NO 
List File . MAP YES 
Libraries .LIB YES 


Table 9-2 MS-LINK Default Filename Extensions 


MS-LINK Command Prompts 


MS-LINK prompts you for the names of Object, Run, and List files, and for 
Libraries. The prompts are listed in order of appearance. For prompts 
that can default to preset responses, the default value is shown in square 
brackets following the prompt. The first prompt has no preset filename 
response and requires you to type a filename. The prompts are: 


Object Modules [.0BJ]: 


Type the filenames of the object modules to be linked. If an object 
module has an extension other than .OBJ, the extension must be 


specified. If no extension is specified, MS-LINK assumes a default 
extension of .OBJ. 


Multiple object modules must be separated by plus signs (4) or spaces. 
For example: 


Object Modules [.OBJ]: FUN TESTPROG PAYPROG PAYLIST 
Remember that MS-LINK loads segments into classes in the order 
encountered. List the object modules in the order you want MS-LINK to 
read them. 


Run File [f7£//ename .EXE]: 


Type a filename for storing the executable Run File that results from 
the link session. All Run Files receive the extension .EXE, even if 
you specify an extension other than .EXE. 
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MS-LINK displays the first filename typed at the Object Modules prompt as 
the default Run File. If no response is typed to the Run File prompt, it 
is used as the Run File. For example: 


Run File [FUN.EXE]: B:PAYROLL 
This response directs MS-LINK to create Run File PAYROLL.EXE on Drive B. 
List File [NUL.MAP]: 


The List File is sometimes called the linker map. The List File 
contains an entry for each segment in the object modules. Each entry 
also shows the addressing in the Run File. 


The default response is NUL.MAP, which means that no List File is 
created. If you want a List File you must type a filename. For 
example: 


List File [NUL.MAP]: B:PAYROLL.REF 


This example instructs MS-LINK to create a List File called PAYROLL.REF 
on Drive B. 


If the List File is sent to a floppy disk, that disk must not be 
removed until the MS-LINK session is ended. 


You can redirect the List File to a printer or the monitor by typing 
the proper reserved filename at the prompt. For example, to route the 
List File to the monitor: 


List File [NUL.MAP]: CON 


Note: If you specify the /P option, the disk containing the List File 
may be removed while the Run File is being written. When it finishes 
writing the .EXE file, MS-LINK prompts you to replace the disk 
containing the List File. 


Libraries [.LIB]: 


You may type up to eight library filenames or simply press RETURN. 
Pressing RETURN instructs MS-LINK to search the library provided as 
part of the compiler package. MS-LINK first searches for the compiler 
library on the default drive. If it cannot find it there, it then 
searches the drive specified by the compiler package. 


If you enter your own library filenames, be sure all files have been 
created by a library utility. You may specify a drive and path for 
each filename. If you do not specify an extension, MS-LINK assumes a 
default extension of .LIB. 
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Library filenames must be separated by blank spaces or plus signs (+). 
For example: 


Libraries [.LIB]: PAYROLL ACCTSPAY ACCTSREC GENLEDGR 


MS-LINK searches library files in the order listed to resolve external 
references. When it finds the module that defines the external symbol, 
MS-LINK processes that module as another object module. 


If MS-LINK cannot find a library file on the disks in the disk drives, 
it displays: 


Cannot find library filename 
Type new drive letter: 


Type the letter for the drive designation. 


VM.TMP (Temporary File) 


MS-LINK uses available memory for the link session. If the files to be 
linked create an output file that exceeds available memory, MS-LINK creates 
a Temporary File named VM.TMP and puts it on the disk in the default 
drive. If MS-LINK creates VM.TMP, it displays the message: 


VM.TMP has been created. 
Do not change disk in drive, d: 


Once this message has been displayed, you must not remove the disk from the 
default drive until the link session ends. If the disk is removed, the 
operation of MS-LINK is unpredictable, and MS-LINK might display the 
message: 


Unexpected end of file on VM.TMP 
The contents of VM.TMP are written to the file specified at the Run File: 
prompt. VM.TMP is a working file only and is deleted at the end of the 
linking session. 
WARNING 
Do not use VM.TMP as a filename for any file. If you have a file named 
VM.TMP on the default drive and MS-LINK requires the VM.TMP file, MS-LINK 


deletes the VM.TMP already on disk and creates a new VM.TMP. Thus, the 
contents of the previous VM.TMP are lost. 
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MS-LINK COMMAND CHARACTERS 
MS-LINK provides three command characters. 
+ (Plus sign) 


A plus sign may be used to separate object modules or libraries on the same 
line. However, you can also use the plus sign to extend the current line 
in response to the Object Modules and Libraries prompts. 


To enter a large number of filenames, type + RETURN at the end of the line 
to extend it. If the + RETURN is the last entry on a line following these 
two prompts, MS-LINK prompts you for additional filenames. 


When the Object Modules or Libraries prompt appears again, continue to type 
responses. When all the modules to be linked and libraries to be searched 
have been listed, end the response line with a RETURN. For example: 


Object Modules [.0BJ]: FUN TXT TABLE CARE + RETURN 
Object Modules [.0BJ]: FOO+FLIPFLOP+JUNQUE + RETURN 
Object Modules [.0BJ]: CORSAIR RETURN 


> (Semicolon) 


You must respond to the Object Modules prompt with specific filenames. Any 
time after the first prompt, however, you can select default responses to 

all of the remaining prompts by typing a single semicolon, followed 
immediately by RETURN. This feature saves time and overrides the need to 
press a series of RETURN keys. For example: 


Object Modules [.OBJ]: FUN TEXT TABLE CARE RETURN 
Run File [FUN.EXE]: ; RETURN 


No other prompts appear, and MS-LINK uses the default values (including 
NUL.MAP, which creates no List File). 


Note: Once the semicolon has been typed and entered by pressing RETURN, 
you can no longer respond to prompts for that link session. Therefore, do 
not use the semicolon to skip some prompts. To skip selected prompts and 
use their default values, press RETURN. 
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CTRL C 


Use CTRL C to abort the link session at any time. If you type an erroneous 
response, such as the wrong filename or an incorrectly spelled filename, 

you may delete the erroneous characters with the backspace key, but for 
that line only. If the error has been typed and you have pressed RETURN to 


enter it, you must press CTRL C to exit the linker session, then restart 
MS-LINK. 


MS-LINK COMMAND OPTIONS 


The seven MS-LINK options control various MS-LINK functions. Options must be 
typed at the end of a prompt response, regardless of the method used to start 
MS-LINK. Options may be grouped at the end of a response, or may be scattered 
at the end of several responses. 


All options may be abbreviated. The only restriction is that an abbreviation 
must maintain the letter sequence of the full form. Examples of legal and 
illegal abbreviations for /DSALLOCATE follow in Table 9-3. 


Legal Illegal 

/D /DSL 

/DS /DAL 

/DSA /DLC 
/DSALLOCA /DSALLOCT 


Table 9-3 Legal/Illegal MS-LINK Command 
Option Abbreviations 


/DSALLOCATE 


Using the /DSALLOCATE (/D) option tells MS-LINK to load all data at the 
high end of the Data Segment (DS). Otherwise, MS-LINK loads all data at 
the low end of the Data Segment. At run time, the DS pointer is set to the 
lowest possible address to allow the entire DS segment to be used. Use of 
the /DSALLOCATE option in combination with the default load low (that is, 
the /HIGH option is mot used) permits an application to dynamically 

allocate any available memory below the area specifically allocated within 
DGroup, yet to remain addressable by the same DS pointer. This dynamic 
allocation is needed for Pascal and FORTRAN programs. 
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Note: Your application program may dynamically allocate up to 64K bytes 


(or the amount of memory available), less the amount allocated within 
DGroup. 


/HIGH 


Use of the /HIGH (/H) option causes MS-LINK to place the Run File as high 


as possible in memory. Otherwise, MS-LINK places the Run File as low as 
possible. 


Caution 


Do not use the /HIGH option with PASCAL or FORTRAN programs. 


/LINENUMBERS 


The /LINENUMBERS (/L) option tells MS-LINK to include in the List File the 
line numbers and addresses of the source statements in the object modules. 
Otherwise, line numbers are not included in the List File. 


Not all compilers produce object modules that contain line number 


information. In these cases, of course, MS-LINK cannot include line 
numbers. 


/MAP 


The /MAP (/M) option directs MS-LINK to list all public (global) symbols 
defined in the input modules. If /MAP is not used, MS-LINK lists only 
errors (including undefined globals) The symbols are listed 
alphabetically. For each symbol, MS-LINK lists its value and its 


segment:offset location in the Run File. The symbols are listed at the end 
of the List File. 


/NO 


The /NO (/N) option is short for NO DEFAULT LIBRARY SEARCH. This option 
tells MS-LINK not to search the default libraries in the object modules. 

For example, if you are linking object modules in Pascal, specifying the 

/NO option tells MS-LINK to not automatically search the library named 
PASCAL.LIB to resolve external references. 


/PAUSE 


The /PAUSE (/P) option causes MS-LINK to pause in the link session to swap 
disks before it outputs the Run (.EXE) File. Normally, MS-LINK performs 
the linking session from beginning to end without stopping. 
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When MS-LINK encounters the /PAUSE option, it displays the message: 


About to generate .EXE file 
Change disks «press RETURN» 


MS-LINK resumes processing when you press RETURN. 


Caution 


Do not remove the disk that receives the List File or the disk used for the 
VM.TMP file, if the file has been created. 


/STACK:n 


All compilers and assemblers should provide information in the object 
modules that allow the linker to compute the required stack size. 


At least one object module must contain a stack allocation statement. If 
not, MS-LINK displays: 


WARNING: NO STACK STATEMENT 


To include your own requirements for stack size, use the /STACK (/S:n) 
option, where n represents a positive numeric value from 0 to 65535. If a 
value from 1 to 511 is typed, MS-LINK uses 512. If the /STACK option is 
not used for a link session or a size of O is assigned with the /stack 
option, MS-LINK calculates the necessary stack size automatically. 


STARTING MS-LINK 


MS-LINK requires two types of input: a command to start MS-LINK and responses 
to command prompts. In addition, seven command options control MS-LINK 
features. Usually, you type all MS-LINK commands on the keyboard in response 
to command prompts. 


MS-LINK asks you for responses to four text prompts. When you have typed a 
response to a prompt and pressed RETURN, the next prompt appears. When the 
last prompt has been answered, MS-LINK begins linking automatically without 
further commands. When the link session is finished, MS-LINK exits to the 
operating system. When the operating system prompt appears, MS-LINK has 
finished successfully. If the link session is unsuccessful, MS-LINK displays 

the appropriate error message. 
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You can start MS-LINK in one of three ways: 


o Command prompts. Type the commands in response to individual prompts. 


o Command line. Type all commmands on the line used to start MS-LINK. 


o Response file. Create a response file that contains all the necessary 
commands and tell MS-LINK where that file is when you start MS-LINK. 


Table 9-4 lists the syntax for each method. 


Command prompts 


Command line 


Response file 


Summary of Methods to Start MS-LINK 


LINK 


LINK [d: ][ path ] Object-f i /ename [ .ext ][ + J[...], 

[ d: ][ path ] Run-fi /ename [ .EXE ], 

[ d: ][ path] L/st-f i /ename [ .ext ], 

[ d: ][ path] Lib-filename[ .ext J[ + ][...][ /options ] 


LINK @[d: ][ path ] Response-f i /ename [ .ext ] 


Table 9-4 Ways to Start MS-LINK 


Method 1: Command Prompts 


To start MS-LINK with Method 1, type: 


link 


MS-LINK is loaded into memory and then displays four text prompts, one at a 
time. Answer the prompts to command MS-LINK to perform specific tasks. 


At the end of each line, you may type one or more options, preceded by the 
option character, a forward slash (/) The prompts are summarized in Table 
9-5 and described in more detail in the MS-LINK Command Prompts section. 
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Prompt 


Object Modules [.0BJ]: 


Run File [f//ename .EXE]: 


List File [NUL.MAP]: 


Libraries [.LIB]: 


Responses 


List object filenames to be linked. They must be 
separated by blank spaces or plus signs (+). If a 
plus sign is the last character typed before you 
press RETURN, the prompt reappears. There is no 
default; a response is required. 


Give filename for executable object code. The 
default is the first object filename specified at 

the Object Modules: prompt. (You cannot change the 
output extension.) 


Type filename for listing. The default is NUL, 
which means that no List File is created. 


List library filenames to be searched, separated by 
blank spaces or plus signs (+). If a plus sign is 
the last character typed before you press RETURN, 
the prompt reappears. The default is to search for 
default libraries using the object module filenames 
(extensions are changed to .LIB). 


Table 9-5 Summary of Command Prompts 


Method 2: Command Line 


To start MS-LINK using Method 2, type all command options on the MS-DOS 
command line. The entries following LINK are responses to the command 
prompts. The entry fields for the four prompts must be separated by 


commas. The syntax is: 


LINK [d: ][ path ] Object-f | lename [ .ext J[+][...], 
[ d: ][ path ] Run-£ i /ename [ .EXE ], [ d: ][ path] List-fi/lename[ .ext ], 
[ d: ][ path] Lib-filename[ .ext ][*][...][ /options ] 


Object-filename is the complete path specification of an object module. 
The ellipsis (...) indicates that more than one object module may be typed, 
separated by plus signs or spaces. 


Run-filename is the name of the .EXE file to receive the executable output. 


List-filename is the name of the file to receive the listing. 


Lib-filename is the complete path specification of a library module to be 
searched. The ellipsis (...) indicates that more than one library module 
may be typed, separated by plus signs or spaces. 
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The /options parameter refers to MS-LINK command options, which may be 
placed following any of the response entries (just before the comma) or 
after the Lib-filename parameter, as shown above. 


To select the default for a field, simply type a comma with no spaces 
preceding or following it. For example: 


LINK ART+SALES+DIV+NOTES/P/M, DIVSALES,COBLIB.LIB 


This command loads MS-LINK, then loads the object modules ART.OBJ, 
SALES.OBJ, DIV.OBJ, and NOTES.OBJ. MS-LINK then pauses in response to the 
/P option. MS-LINK links the object modules when you press a key. The 
comma in the Run-filename parameter instructs MS-LINK to create the default 
ART.EXE Run File. It then creates a List File named DIVSALES.MAP, and 
produces a global symbol map in response to the /M option. During 
processing, MS-LINK searches the Library file COBLIB.LIB. 


Method 3: Response File 
To start MS-LINK with Method 3, the syntax is: 
LINK e[d: ][ path ] Response-f | /ename [ .ext ] 


When starting MS-LINK using this method, you supply the filename and 
optional extension of a response file. Drive and path may be entered if 
the response file is not located in the root directory of the default 

drive. You must precede the response file specification with an "at" sign 


(e). 


To use this option, you must create a response file containing several 
lines of text, each of which is the response to an MS-LINK command prompt. 


The response file may also contain any of the options. Method 3 permits 
the command that starts MS-LINK to be entered from the keyboard or within a 
batch file without requiring you to take further action. 


Type the commands in your response file in the same order as the MS-LINK 
prompts discussed in Method 1. You may type a long response to the 
Object Modules or Libraries prompt on several lines by using a plus sign 

(+) to continue the same response on the next line. Use options and 
command characters in the response file just as they are typed on the 
keyboard in response to MS-LINK prompts. 


When the MS-LINK session begins, each prompt is displayed with the 


responses from the response file. If the response file does not contain 
answers for all the prompts (in the form of filenames, the semicolon 
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command character or carriage returns), MS-LINK displays the prompt that 
does not have a response, then waits for you to respond. When a valid 
response is typed, MS-LINK continues the link session. See the following 
example: 


ART SALES DIV NOTES 
/ PAUSE /MAP 
DIVSALES 

COBL IB.L IB 


This response file tells MS-LINK to load the four object modules named ART, 
SALES, DIV, and NOTES. MS-LINK pauses to permit you to swap disks (see 
/PAUSE in the MS-LINK Command Options section before using this feature). 
When you press a key, MS-LINK creates a Run File named ART.EXE and a List 
File named DIVSALES.MAP (a public symbol map, because of the /MAP option). 
MS-LINK searches the library file COBLIB.LIB, and uses the default settings 
for all other command options. 


SAMPLE MS-LINK SESSION 


This sample shows you the type of information that is displayed during an 
MS-LINK session. Before starting the session, make sure the LINK.EXE file is 
on the disk in the default drive and the MS-DOS prompt is displayed. To start 
MS-LINK, type: 


link 


The system displays the following messages and prompts. Your answers in this 
example are shown in bold type: 


Microsoft 8086 Object Linker 
Version 2.30 (C) Copyright Microsoft Corp 1983, 1984 


Object Modules [.OBJ]: IO SYSINIT RETURN 
Run File [IO.EXE]: RETURN 

List File [NUL.MAP]: IO /MAP RETURN 
Libraries [.LIB]: RETURN 


The IO/MAP entry in response to the List File prompt creates a List File named 
IO.MAP that contains both an alphabetic listing and a chronological listing of 
public symbols. 


By pressing RETURN in response to the Libraries prompt, you specify an 
automatic library search. 
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Once MS-LINK locates all libraries, the linker map displays a list of segments 


in the order of their appearance within the load module. 
following format: 


Start 


OO000H 
OO9F OH 


Stop Length 
OO9ECH O9EDH 
O1166H 7774 


The list has the 


The information in the Start and Stop columns shows the 20-bit hexadecimal 


address of each segment relative to location zero. 


beginning of the load module. 


Location zero is the 


The addresses displayed are not the absolute addresses where these segments are 


loaded. 


Because the /MAP option was used, MS-LINK displays the public symbols by name 


and value. 


ADDRESS 


OO9F : 
OO9F : 


For example: 


PUBLICS BY NAME 
BUFFERS 
CURRENT. DOS. LOCAT | ON 
DEFAULT. DRIVE 

DEVICE LIST 

FILES 
FINAL. DOS, LOCAT | ON 
MEMORY, SIZE 

SYSINIT 


PUBLCS BY VALUE 
SYSINIT 
CURRENT. DOS, LOCAT | ON 
FINAL. DOS LOCAT | ON 
DEVICE LIST 

MEMORY. SIZE 

DEFAULT. DRIVE 
BUFFERS 

FILES 
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ERROR MESSAGES 


All errors cause the link session to abort. After the cause has been found and 
corrected, MS-LINK must be rerun. The error messages displayed by MS-LINK are: 


Attempt to access data outside of segment bounds, possibly bad object module 
There is probably a bad object file. 


Bad numeric parameter 
Numeric value is not in digits. 


Cannot open temporary file 
MS-LINK is unable to create the file VM.TMP because the disk directory is 
full. Insert a new disk. Do not remove the disk receiving the LIST.MAP 
file. 


Error: dup record too complex 
DUP record in assembly language module is too complex. Simplify DUP record 
in assembly language program. 


Error: fixup offset exceeds filed width 
An assembly language instruction refers to an address with a short 
instruction instead of a long instruction. Edit assembly language source 
and reassemble. 


Input file read error 
There is probably a bad object file. 


Invalid object module 
An object module(s) is incorrectly formed or incomplete. 


Program size or number of segments exceeds capacity of linker 
The total size exceeds 384K bytes or the number of segments exceeds 255. 


Requested stack size exceeds 64K 
Specify a size greater than or equal to 64K bytes with the /STACK option. 


Segment size exceeds 64K 
64K bytes is the addressing system limit. 


Symbol defined more than once 
MS-LINK found two or more modules that define a single symbol name. 


Symbol table capacity exceeded 


Too many and/or very long names were typed, exceeding the limit of 
approximately 25K bytes. 
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Too many external symbols in one module 
The limit is 256 external symbols per module. 


Too many groups 
The limit is 10 groups. 


Too many libraries specified 
The limit is 8 libraries. 


Too many public symbols 
The limit is 1024 public symbols. 


Too many segments or classes 
The limit is 256 (segments and classes taken together). 


Unresolved externals:  //st 
The external symbols listed have no defining module among the modules or 
library files specified. 


VM read error 
This is a disk error; it is not caused by MS-LINK. 


Warning: no stack segment 
None of the object modules specified contains a statement allocating stack 
Space, but you typed the /STACK option. 


Warning: segment of absolute or unknown type 
There is a bad object module or an attempt has been made to link modules 
that MS-LINK cannot handle (e.g., an absolute object module). 


Write error in tmp file 
No more disk space remains to expand the VM.TMP file. 


Write error on run file 
Usually, there is not enough disk space for the Run File. 
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ABOUT DEBUG 


DEBUG is a debugging program used to provide a controlled testing environment 
for binary and executable object files. Note that EDLIN is used to edit source 
files; DEBUG is used to edit binary files. DEBUG eliminates the need to 
reassemble a program to see if a problem has been fixed by a minor change. It 
allows you to alter the contents of a file or the contents of a CPU register 
and then immediately reexecute a program to check the validity of the changes. 


DEBUG can be used to execute any object file. Object files are executable 
programs in machine language. 


All commands and parameters may be entered in either upper- or lowercase. Any 
combination of upper- and lowercase may be used in commands. 


STARTING DEBUG 
To start DEBUG, at the MS-DOS prompt, use the syntax: 
DEBUG [d: ][ path ][ £//ename [ .ext ]] [ parm7 ] [ parm2 ] 


You may follow the DEBUG command with the filename and optional extension of 
the object file to be loaded into memory. You may specify a drive and path. 
Parml1 and parm2 represent optional parameters for the object file. For 
example, if you type: 


DEBUG B:NDOSFILESNDISKCOMP.COM A: B: 


DEBUG loads DISKCOMP.COM from the directory NDOSFILES in Drive B into memory 
starting at 100 hexadecimal in the lowest available segment. The A: and B: 
entries are parameters to the program DISKCOMP. 


If no filename is specified following the DEBUG command, the current memory 
contents are used. You can load a file later using the DEBUG Name and Load 
commands, or you can read absolute disk sectors into memory with the Load 
command. 


When DEBUG starts, the program sets registers and flags for the object file. 
BX:CX registers are loaded with the number of bytes loaded into memory. All 
available memory is allocated, so the object program cannot allocate memory. 


DEBUG also sets up a program header at offset O in its program work area. On 
previous versions you could overwrite this header. This is still true for the 
default header set up if no filename is given to DEBUG. If you are running 
DEBUG on a .COM or .EXE file, however, do not tamper with the header of the 
program below address SCH, or the system will crash. 
No attempt is made to restart a program once this message appears: 

Program terminated normally 
The program must be reloaded with the N (Name) or L (Load) commands to run 


properly. 
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The DEBUG prompt is a hyphen (-). It indicates DEBUG is waiting for a command 
and optional parameters to be entered. The DEBUG parameters and commands are 
covered in the following sections. 


DEBUG PARAMETERS 


All DEBUG commands accept parameters, except the Quit command. Parameters may 
be separated by delimiters (commas or spaces), but a delimiter is required only 
between two consecutive hexadecimal values. For example, the following 

commands are equivalent: 


DCS: 100 110 
D CS: 100 110 
D,CS: 100,110 


Entries can be any combination of upper- or lowercase characters. The DEBUG 
parameters are listed in Table 10-1. 


Parameter Definition 


address A one- or two-part designation consisting of either an 
alphabetic segment register designation or a four-digit 
segment address plus an offset value. If the segment 
designation or segment address is omitted, the default 
segment is used. DS is the default segment for all 
commands except G, L, T, U, and W, for which the default 
segments is CS. All numeric values are hexadecimal and are 
entered as 1-4 characters. For example: 


CS:0100 
O4BA : 0100 
100 


The colon is required between a segment designation 
(whether numeric or alphabetic) and an offset. All memory 
locations specified in an address must be valid. 


byte A one- or two-digit hexadecimal value to be placed in or 
read from an address or register. (The hex values 1 and 01 
are equivalent.) 


drive A one- or two-digit hexadecimal value to indicate which 
drive a file will be loaded from or written to. The valid 
values are 0-3 (or 00-03), which designate the drives: 
A: = 0, B: = 1, C: = 2, D: = 3. 
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Parameter Definition 


list One or more byte values or string values. List must be the 
last parameter on the command line. For example: 


fcs:100 42 45 52 54 41 


portaddress One- to four-character hexadecimal value to specify the 
port address. 


range Two formats exist: either address address or 
address L value. In the first format, only an offset 
address is allowed as the second address; addresses must be 
separated by a comma or space. In the second format, value 
is the number of bytes (in hexadecimal) the commands should 
process. All memory locations specified must be valid. 


Valid examples are: 


CS:100 110 
CS:100 L 10 


The following example is not valid: 


CS:100 CS:110 
error 


The limit for range is hex 10000 (the sum of address and 
value in the second format cannot exceed 64K). To specify 
a value of 10000 hex within four digits, enter 0000 (or 0). 


record A one- to three-digit hexadecimal value used to indicate 
the logical record number on the disk and the number of 
disk sectors to be written or loaded. Logical records 
correspond to sectors. However, their numbering differs 
since they represent the entire disk space. 


regi stername A one- or two-character name, used to display the contents 
and flags of a specific register. See the R (Register) 
command for a list of valid registernames. 


sector sector One- to four-character hexadecimal value to indicate the 
starting relative sector on a disk and the number of 
consecutive sectors to be Loaded or Written. A maximum of 
80 sectors can be specified in a single command. Each 
sector contains 512 bytes. 
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Parameter Definition 


Relative sectors can be calculated as follows (assuming 
double sided disks, 9 sectors/track): 


Side Sector Track Relative Sector 
0 1 0 0 (hex) 
0 2 0 1 
0 3 0 2 
0 9 0 8 
1 1 0 9 
1 2 0 0A 
1 3 0 OB 
1 9 0 11 
O 1 1 12 
1 9 39(dec) 2CF 
string A character string, enclosed in either single () or double 


(7 quotes as delimiters. DEBUG uses the ASCII values of 
the characters in the string as a list of byte values. If 
you open a string with one type of quotes, you can use the 
opposite type as characters. For example: 


"This “string” is valid" 
‘This "string" is valid’ 


If you need to specify the same type of quotes as 
characters that you used as delimiters, you must use double 
sets of quotes. For example: 
"Ihre **string"" 16 valid" 
‘This ''string'' is valid’ 
"This "string" is NOT valid" 
value A one- to four-digit hexadecimal value used to specify the 
number of instructions to be Traced, the number of bytes to 


be processed, or the numbers to be added or subtracted in 
the H (Hex) command. 


Table 10-1 Debug Parameter Definitions 
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DEBUG COMMANDS 


Each DEBUG command consists of a single letter, usually followed by one or more 
parameters. 


DEBUG commands are consistent with the control character and special editing 
functions at the MS-DOS command level. Commands become effective only after 
you press RETURN. 


All DEBUG commands may be stopped at any time by pressing CTRL C or CTRL BREAK. 
Pressing CTRL S or CTRL NUM LCK suspends the display, so that you can read it 
before the information scrolls off the top of the screen. Pressing keys other 


than CTRL C, CTRL BREAK, CTRL NUM LCK, or CTRL S restarts the display. 


If a syntax error occurs in a DEBUG command, DEBUG redisplays the command line 
and indicates the error with a caret (^) and the word error. For example: 


d6s: 100. cs: TIO 
^error 
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A. (Assemble) 


Purpose 
The A command assembles 8086/8087/8088 assembly language mnemonics directly 
into memory. 

Syntax 


A [ address ] 


Comments 
Assembly statements entered are assembled in successive memory locations 
starting at the address specified. If no address is given, the default 
beginning address is at CS:0100. To stop entering statements, press RETURN 
at an empty DEBUG prompt (-). 


An invalid statement displays error and redisplays the current memory 
address. 


All numeric values must be entered in one- to four-character hexadecimal 
values. 


Prefix mnemonics must be entered immediately before the opcode which they 
reference. They may be entered on a separate line. 


CS:, DS:, ES:, and SS: are the four segment override mnemonics. 


String manipulation mnemonics must specify the string size. MOVSW must be 
used to move word strings; MOVSB must be used to move byte strings. 


The mnemonic string for a far return is REIF. 
DEBUG assembles short, near, and far jumps (or calls) according to the 
displacement to the destination address. You can override these with the 
NEAR (abbreviated NE) or FAR prefixes. For example: 

JMP NEAR 010A 
DEBUG cannot distinguish whether certain operands refer to a byte or a word 
memory location. The data type must be specified by the prefixes WORD PTR 
(abbreviated WO) and BYTE PTR (abbreviated BY). For example: 


NEG BYTE PTR [128] 
DEC WO [S!] 
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DEBUG also cannot tell whether an operand refers to a memory location or to 
an immediate operand. Enclose operands that refer to memory in square 
brackets. For example: 


MOV AX,21 ;Load AX with 21H 
MOV AX,[21] ;Load AX with the contents of memory location 21H 


Any of the addressing modes can be used. All forms of the register 
indirect commands are supported. 


All 8086/8087/8088 opcode synonyms, as well as the pseudo instructions DB 
and DW, are supported by DEBUG. For example: 


LOOPZ 100 
LOOPE 100 
JA 100 
JNBE 100 


DB 1,2,3,4,"THIS IS AN EXAMPLE" 
DB ‘THIS IS A QUOTE:"' 

DB "THIS IS A QUOTE: '" 

DW 1000, 2000, 3000, "BACH" 


The 8087 prefixes WAIT and FWAIT must be defined before the opcode they refer 
to. 
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C (Compare) 


Purpose 


The C command compares the portion of memory specified by range to a 
portion of the same size beginning at address. 
Syntax 


C range address 


Comments 
If the two areas of memory specified are identical, there is no display and 
DEBUG returns the prompt. If there are differences between the two areas 
of memory, they are displayed as: 


address! bytel byte2 address2 


Examples 
C100,200 300 
Or 
C100L 100 300 


Compares the block of memory from 100 to 200H with the block of memory 
from 300 to 400H. L100 in the second example specifies the range. 
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D (Dump) 


Purpose 


The D command displays the memory contents of either a single address, a 
range of addresses, or the number of lines specified by value beginning at 
the address entered. 


Syntax 
D[ address [L va/ue ]] 
or 


D[ range ] 


Comments 


If only a single address is specified, the contents of 128 bytes are 
displayed. If a range of addresses is specified, the contents of the range 
are displayed. If the D command is entered without parameters, the result 
is the same as if you specified a single address, except that the display 
begins at the current location in the data segment (DS). 


The dump is displayed in two portions: a hexadecimal dump, with each byte 
shown in hexadecimal, and an ASCII dump, with each byte displayed as an 
ASCII character. Nonprinting characters are denoted by a period (.) in the 
ASCII portion of the display. Each display line shows sixteen bytes, with 

a hyphen between the eighth and ninth bytes. 


Note: At times, the displays shown as examples in this book are split to 
fit them on a page. 


Each displayed line begins on a 16-byte boundary. The first line contains 
fewer bytes than the rest of the displayed lines. 


Examples 


DCS: 100 110 
O4AB:0100 42 45 52 54 41 ... 4E 44 BERTA T. BORLAND 


In response to the command on the first line, DEBUG displays a dump in 
the format shown on the second line. Each line of the display begins 
with an address, incremented by 16 from the address on the previous 
line. Each subsequent D (entered without parameters) displays the 
bytes immediately following those last displayed. 


DCS:100 L 20 


The display is formatted as described above, but all bytes for 20H 
addresses are displayed. 
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E (Enter) 


Purpose 


The E command enters the address, displays its contents, and waits for more 
input. 


Syntax 


E address [ /ist ] 


Comments 


If the optional list of hexadecimal values is entered, the replacement of 
byte values occurs automatically. If an error occurs, no byte values are 
changed. If the address is entered without the optional list, DEBUG 
displays the address, its contents, and a period, then waits for you to 
make more entries. At this point, Enter waits for you to do one of the 
following: 


1. Replace a byte value with another value you type. You simply type a 
value after the current value. If the new value is not a legal 
hexadecimal value or if more than two digits are typed, the illegal or 
extra character is not displayed. 


2. Press the SPACEBAR to advance to the next byte. To change the value, 
simply enter a new value as described in step 1 above. If you space 
beyond an eight-byte boundry, DEBUG starts a new display line with 
address displayed at the beginning. 


3. Type a hyphen to return to the preceding byte. If you decide to change 
a byte behind the current position, typing the hyphen returns the 
current position to the previous byte. When the hyphen is typed, a new 
line is started with the address and its byte value displayed. 


4. Press RETURN at any byte position to end the Enter command. 


Examples 


ECS: 100 
O4BA:100 EB. 


In response to the command on the first line, DEBUG returns the second 
line. To change this value to 41, enter "41" as shown: 


O4BA:100 — EB.41 
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To step through the subsequent bytes, press the SPACEBAR to see: 
O4BA:100  EB.41 10. OO. BC. 

To change BC to 42: 
O4BA:100  EB.41 10. 00.  BC.42 


Now, realizing that 10 should be 6F, enter the hyphen as many times as 
needed to return to byte 0101 (value 10), then replace 10 with 6F: 


O4BA:100  EB.41 10. OO.  BC.42-- 
04BA: 102 0O0.-- 
O4BA.101 10.6F 


Pressing RETURN ends the Enter commands and returns to the DEBUG 
command level. 
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F (Fill) 


Purpose 


The F command fills the addresses in range with the values in list. 


Syntax 


F range /ist 


Comments 


The F command is a multiple version of the E command that lets you change 
more than one address at a time. If the range contains more bytes than the 
number of values in the list, the list is used repeatedly until all bytes 

in range are filled. If list contains more values than the number of bytes 
in range, the extra values in list are ignored. If any of the memory in 
range is not valid (bad or nonexistent), the error is propagated into all 
succeeding locations. 


Example 
FO4BA:100 L 100 42 45 52 54 41 


Fills memory locations O4BA:100 through 4BA:1FF with the bytes 
specified. The five values are repeated until all 100H bytes are 
filled. 
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G (Go) 


Purpose 


The G command executes the program currently in memory. 


Syntax 


G[ =address ] [ address ...] 


Comments 


If the Go command is entered alone, the program executes as if the program 
had run outside of DEBUG. 


If =address is set, execution begins at the address specified. If the 
segment designation is omitted from =address, only the instruction pointer 
is set. If the segment designation is included in -address, both the CS 
segment and the instruction pointer are set. The equal sign (=) is 
required to distinguish the start address from the breakpoint addresses. 


With the other optional addresses set, execution stops at the first address 
encountered, regardless of that address' position in the list of addresses 
to halt execution or which branch the program takes. When program 
execution reaches a breakpoint, the registers, flags, and decoded 
instruction are displayed for the instruction at the breakpoint address 
(the last instruction executed). The result is the same as if you had 
entered the Register command for the breakpoint address. 


Up to ten breakpoints may be set. Breakpoints may be set only at addresses 
containing the first byte of an 8086 opcode. If more than 10 breakpoints 
are set, DEBUG returns the message: 


BP 


The user stack pointer must be valid and have six bytes available for this 
command. The G command uses an IRET instruction to cause a jump to the 
program under test. The user stack pointer is set, and the user flags, 
code segment register, and instruction pointer are pushed on the user 
Stack. (Thus, if the user stack is not valid or is too small, the 

operating system may be disrupted.) An interrupt code (OCCH) is placed at 
the specified breakpoint address(es). When an instruction with the 
breakpoint code is encountered, all breakpoint addresses are restored to 
their original instructions. If execution is not halted at one of the 
breakpoints, the interrupt codes are not replaced with the original 
instructions. 
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Example 
GCS : 7550 


Executes the program currently in memory up to the address 7550 in the 
CS segment. The DEBUG displays registers and flags, after which the Go 
command is terminated. After a breakpoint has been found, if you enter 
the Go command again, the program executes just as if you had entered 
the filename at the MS-DOS command level, except that program execution 


begins at the instruction at the breakpoint rather than at the usual 
start address. 
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H (Hex) 


Purpose 


The H command performs hexadecimal arithmetic on two parameters. 


Syntax 


H va/ue va/ue 


Comments 
DEBUG first adds the two parameters, then subtracts the second parameter 


from the first. The results of the arithmetic are displayed on one line: 
first the sum, then the difference. 


Example 
H10A 19F 
DEBUG performs the calculations and then displays the results: 


O2A9 FF6B 
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I (Input) 


Purpose 


The I command inputs and displays one byte from the port specified by 
portaddress. 
Syntax 


| portaddress 


Comments 
An 8- or 16-bit portaddress is allowed. Use a one- to four-digit 
hexadecimal number. 

Example 
|2F8 


Assuming that the byte at the port is 42H, DEBUG inputs the byte and 
displays the value: 


42 
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L (Load) 


Purpose 


The L command loads a file or disk sectors into memory. 


Syntax 


L [address [drive sector sector ]] 


Comments 


Set BX:CX to the number of bytes read. The file must have been named 
either with the DEBUG startup command or with the N command. Loading a 
file on the startup command line or with the N command sets a file control 
block at CS:SC. 


If the L command is given without any parameters, DEBUG loads all .COM 
files into memory beginning at address CS:100 and sets BX:CX to the number 
of bytes loaded. If the L command is given with an address parameter, 
loading begins at the memory address specified. If L is entered with all 
parameters, absolute disk sectors are loaded, rather than a file. The 
sectors are taken from the drive specified (the drive designation is 

numeric where A: = O, B: = 1, C: = 2, and D: = 3). DEBUG begins loading 
with the first sector specified and continues until the number of sectors 
specified in the second sector have been loaded. 


If the file has a .EXE extension, it is relocated to the load address 
specified in the header of the .EXE file: the address parameter is always 
ignored for .EXE files. 


Note: The .EXE file header is stripped from the .EXE file before it is 
loaded into memory. The size of a .EXE file on disk is different from the 
size of the file in memory. 


If the file named by the Name command or specified on at startup on the 
command line is a .HEX file, then entering the L command with no parameters 
causes loading of the file beginning at the address specified in the .HEX 

file. If the L command includes the option address, DEBUG adds the address 
specified in the L command to the address found in the .HEX file to 
determine the start address for loading the file. 
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Example 


A:DEBUG 
-NF ILE . COM 


Now, to load FILE.COM, enter: 
-L 


Loads the file and returns the DEBUG prompt. Assuming you want to load 
only portions of a file or certain records from a disk. To do this, enter: 


LO4BA: 100 2 OF 6D 


Loads 109 (6D hex) records, beginning with logical record number 15, into 
memory beginning at address 04BA:0100. When the records have been loaded, 
DEBUG simply returns to its prompt. 
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M (Move) 


Purpose 


The M command moves the block of memory specified by range to the location 
beginning at the address specified. 


Syntax 


M range address 


Comments 


Overlapping move operations, where part of the block overlaps part of the 
current address, are always performed without loss of data. Addresses that 
could be overwritten are moved first. The sequence for moves from higher 
addresses to lower addresses is to move the data beginning at the block's 
lowest address, working toward the highest. The sequence for moves from a 
lower address to a higher one is to move the data beginning at the block's 
highest address, working toward the lowest. 


Note: If the addresses in the block being moved will not have new data 
written to them, the data there before the move remains. That is, the Move 
command really copies the data from one area to another, in the sequence 


described, and writes over the new addresses. This is why the sequence of 
the move is important. 


Example 
MCS:100 110 CS:500 


DEBUG first moves address CS:110 to address CS:510, then CS:10F to 
CS:SOF, and so on until CS:100 is moved to CS:500. You should enter 


the D command, using the address entered for the M command, to review 
the results of the move. 


10-20 / DEBUG 


N (Name) 


Purpose 


The N command sets filenames. 


Syntax 


N[d: ][ path] £//ename [ .ext ] [[ d: ][ path] fi /ename [ .ext ]] 


Comments 


The Name command performs two distinct functions, both having to do with 
filenames: 


o Assigning a filename for a later Load or Write command 
o  Assigning filename parameters to the file being debugged 


If you invoke DEBUG without naming any file, the N command must be given 
before a file can be loaded. 


These functions overlap. Consider the following set of DEBUG commands: 
=NFILE TENE 


eL 
Ne 


Because of the double effect of the Name command, the following happens: 


1. Name assigns the filename FILE1.EXE to be used in any later Load or 
Write commands. 


2. Name also assigns the filename FILE1.EXE to be used by any program that 
is later debugged. 


3. The Load command loads FILE1.EXE into memory. 

4. The Go command executes FILE1.EXE with FILE1.EXE as the single filename 
parameter (FILE1.EXE is executed as if FILE1 had been typed at the 
command level.) 

A more useful chain of commands might be: 

-NFILETEXE 
eL. 


-NFILE2.DAT FILE3.DAT 
-G 
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In this case, Name sets FILE1.EXE as the filename for the subsequent Load 
command. The Load command loads FILE1.EXE into memory, and then the Name 
command is used again, this time to specify the parameters to be used by 
FILE1.EXE. Finally, when the Go command is executed, FILE1.EXE is executed 
as if FILE1 FILE2.DAT FILE3.DAT had been typed at the MS-DOS command level. 


Note: If a Write command were executed at this point, FILE1.EXE, the file 
being debugged, would be saved with the name FILE2.DAT. To avoid this, you 
should always execute a Name command before either a Load or a Write 
command. 


There are four distinct regions of memory that can be affected by the Name 


command: 
Cor SC FCB for file 1 
CS: 6C FCB for file 2 
CS:80 Count of characters 
9:81 All characters entered 


The File Control Block (FCB) for the first filename parameter specified 

with the Name command is set at CS:SC. If a second filename parameter is 
specified, then the FCB is set beginning at CS:6C. The number of 
characters typed in the Name command (after the N) is given at location 


CS:80. The actual stream of characters given by the Name command begins at 
CS:81. 


Note: This stream of characters may contain any switches and delimiters 
that would be legal at the MS-DOS command level. 

Example 
DEBUG PROG.COM 


-NPARM1 PARM2/C 
- 


Executes the file in memory as if the following commmand line had been 
entered: 


PROG PARM1 PARM2/C 


Testing and debugging therefore reflect a normal runtime environment 
for PROG.COM. 
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O (Output) 


Purpose 


The O command sends the byte specified to the output port specified in 
portaddress. 


Syntax 


O portaddress byte 


Comments 


A 16-bit port address is allowed. Use a one- to four-digit hexadecimal 
number. 


Example 
O2F8 4F 


Outputs the byte value 4F to output port 2F8. 
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P (Proceed) 


Purpose 


The P command executes a specified subroutine call, loop instruction, 
interrupt, or repeat string instruction and then stops at the next 


instruction. 


Syntax 


P [ =address ] [ va/ue ] 


Comments 


Use the P command to execute the instruction starting at CS:IP or at 
=address if it is specified. The subroutine call, loop instruction, 
interrupt, or repeat string instruction is executed, and DEBUG returns 


control at the next instruction. 


is specified. 


One instruction is assumed unless a value 


If you use Proceed to execute multiple instructions, displays may scroll 
off the screen. You can halt the scrolling at any time by pressing CTRL 
NUM LCK. Press any character key to resume scrolling. 


Example 


The following program contains a subroutine call at CS:0102: 


OD55:0100 BO10 
OD55:0102 E81BOO 
OD55:0105 B320 
QD55:0107 3DOOO0 
OD55:010A A90300 
OD55:010D 8904 
OD55:010F 894404 


-P-102 5 


AL , 10 
0120 
BL,20 

AX , 0000 

AX , 0003 
[SI], AX 
[S1+04],AX 


Executes the call at address 102 as one instruction. A total of five 
instructions are executed, including the instruction at address 102. 
DEBUG displays the status of the registers and flags after each 
instruction is executed. 
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Q (Quit) 


Purpose 


The Q command ends a DEBUG session. 


Syntax 


Q 


Comments 


The Quit command takes no parameters and exits DEBUG without saving the 
file currently being debugged. You are returned to the MS-DOS command 
level. 


WARNING 


If you want to save the file, you must use the Write command before issuing 
the Quit command. 


Example 


Q 


Terminates DEBUG and returns control to the MS-DOS command level. 
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R (Register) 


Purpose 


The R command displays the contents of one or more CPU registers. 


Syntax 


R [ reg/stername | 


Comments 


If no registername is entered, the R command dumps the register save area 
and displays the contents of all registers and flags. 


If a registername is entered, the 16-bit value of that register is 

displayed in hexadecimal, and then a colon (:) appears as a prompt. You 
then either enter a value to change the register, or simply press RETURN if 
no change is required. The only valid registernames are: 


AX BP SS 
BX SI CS 
CX DI IP 
DX DS PC 
SP ES ly 


Any other entry for registername results in a BR error message. 


If F is entered as the registername, DEBUG displays a two-character 
alphabetic code. The flags are either set or clear. To alter the flag, 
enter the opposite two-letter code. The flags and their codes for set and 
clear are listed below: 


Flag Name Set Clear 

Over f | ow OV NV 

Di rection DN (decrement) UP (increment) 
Interrupt El (enabled) DI (disabled) 
Sign NG (negative) PL (plus) 
Zero ZR NZ 

Auxiliary Carry AC NA 

Parity PE (even) PO (odd) 
Carry CY NC 


Table 10-2 Register Flags 
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Whenever you enter the command RF, the flags are displayed in the order 
shown above in a row at the beginning of a line. At the end of the list of 
flags, DEBUG displays a hyphen; you may enter new flag values as alphabetic 
pairs. The new flag values can be entered in any order, with or without 
spaces between the flag entries. 


To exit the R command, press RETURN. Flags for which new values were not 
entered remain unchanged. 


If more than one value is entered for a flag, DEBUG returns a BF error 

message. If you enter a flag code other than those shown above, DEBUG 
returns a BF Error message. In both cases, the flags up to the error in 
the list are changed; flags at and after the error are not. 


At startup, the segment registers are set to the bottom of free memory, the 
Instruction Pointer is set to 0100H, the Stack Pointer is set to FFFOH, all 
flags are cleared, and the remaining registers are set to zero. 

Example 
R 


Displays all registers and flags and the decoded instruction for the 
current location, as in the example below for CS:11A: 


AX-OEO0 BX=OOFF CX-O0007 DX=01FF SP=039D BP=0000 
$12005C DI=0000 DS=04BA ES-04BA SS=04BA CS=04BA 
IP2001A NV UP DI NG NZ AC PE NC O4BA:011A CD21 INT 21 
If you then enter: 
RF 
DEBUG displays the flags: 
NV UP DI NG NZ AC PE NC - 


Now enter any valid flag designations, in any order, with or without 
spaces. For example: 


NV UP DI NG NZ AC PE NC -PLEICY 


DEBUG responds only with the DEBUG prompt. To see the changes, enter 
either the R or RF command: 


RF 
NV UP EI PL NZ AC PE CY- 


Press RETURN to leave the flags this way, or enter different flag 
values. 
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S (Search) 


Purpose 


The S command searches the range specified for the list of bytes specified 
and displays the bytes where matches are found. 
Syntax 


S range list 


Comments 
The Search command displays the addresses where a match was found of bytes 
specified in list. The list may contain one or more bytes, separated by a 
space or comma. If the list contains more than one byte, only the first 
address of the byte string is returned. If the list contains only one 
byte, all addresses of the byte in the range are displayed. 


If no match is found, the DEBUG prompt (-) is displayed. 


Example 
SCS: 100 110 47] 
If two matches are found, DEBUG might return the response: 


O4BA :0104 
04BA : O10D 
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T (Trace) 


Purpose 


The T command executes one instruction and displays the contents of all 
registers and flags and the next decoded instruction. 


Syntax 


T [address ] [ va/ue ] 


Comments 


If the optional =address is entered, tracing occurs at the address 
specified. If =address includes the segment designation, then both CS and 
the instruction pointer are specified. If =address omits the segment 
designation, only the instruction pointer is specified. 


One instruction is assumed unless a value is specified. If value is 
specified, DEBUG executes and traces the number of steps specified. 


If you use Trace to execute multiple instructions, displays may scroll off 
the screen. You can halt the scrolling at any time by pressing 
CTRL NUM LCK. Press any character key to resume scrolling. 


Examples 
T 


Returns a display of the regisers, flags, and decoded intruction for 
the instruction pointed to by the CS:IP. If the current position is 
04BA:011A, DEBUG might return the display: 


AX-OEO0 BX-OOFF CX=0007 DX=01FF SP=039D BP=0000 
S!=O005C DI=0000 DS=04BA ES=04BA SS=04BA CS=04BA 
IP20011A NV UP DI NG NZ AC PE NC O4BA:011A CD21 INT 21 


T=011A 10 


Executes ten instructions beginning at 011A in the current segment and 
then displays all registers and flags for each instruction as it is 
executed. The display scrolls away until the last instruction is 
executed. Then the display stops, and you can see the register and 
flag values for the last few instructions performed. 


DEBUG | 10-29 


U (Unassemble) 


Purpose 


The U command disassembles bytes and displays the source statements that 
correspond to them, along with addresses and byte values. 


Syntax 
U[ address [L va/ue ]] 
or 
U[ range ] 

Comments 


The display of unassembled code looks like a listing for an assembled 

file. If you enter the U command without parameters, 20 hexadecimal bytes 
are disassembled to show corresponding instructions. If you enter the U 
command with the range parameter, DEBUG disassembles all bytes in the 
range. If there are fewer bytes in the range than 20 hex, only the bytes 
in the range are displayed. 


If you enter the U command with only the address parameter, DEBUG 
disassembles the default number of bytes, beginning at the address 

specified. If you enter the U command with the address L value parameters, 
DEBUG disassembles all bytes beginning at the address specified for the 
number of bytes specified by value. Entering the U command with the 
address L value parameters overrides the default limit of 20H bytes. 


Examples 
UO4BA : 100 

Disassembles 32 bytes beginning at address 04BA:0100, formatted as 

follows: 
O4BA:0100 027403 ADD DH, [S1+03] 
O4BA:0103 E971D5 JMP D677 
O4BA:0106 36 SS: 
O4BA:0107 8B16C82F MOV DX, [2FC8] 
O4BA:010B BEO100 MOV SI, 0001 
O4BA:O10E 36 SS: 
O4BA:010F A9CC42F MOV AX, [2FC4] 
O4BA:0112 OBCO OR AX, AX 
O4BA:0114 7405 JZ OTIB 
O4BA:0116 48 DEC AX 
O4BA:0117 8ED8 MOV DS, AX 
O4BA:0119 8914 MOV [SI ],DX 
04BA:011B 36 SS: 
O4BA:0O11C A1C82F MOV AX, [2FC8] 
O4BA:O11F 48 DEC AX 
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UO4BA:0100 0108 


Displays: 
04BA:0100 027403 ADD DH, [DI403] 
O4BA:0103 3971D5 JMP D677 
O4BA: 0106 36 SS: 
O4BA:0107 8B16C82F MOV DX, [2FC8] 


UO4BA: 100 120 


Appears exactly as with the USC:100 command. If, however, you enter 
the command: 


UO4BA: 100 L 120 


all of the bytes beginning at address CS:100 through address CS:220 are 
disassembled and displayed. 


If the bytes in some addresses are altered, the disassembler alters the 
instruction statements. 
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W (Write) 


Purpose 
The W command writes the file currently being debugged to a disk file. 
Syntax 


W[ address [drive sector sector ]] 


Comments 


If the Write command is entered without parameters, BX:CX must already be 
set to the number of bytes to be written. DEBUG writes the file to disk 
beginning from CS:100. The debugged file is written to the disk from which 
it was loaded. This means that the debugged file is written over the 
original file loaded into memory. If a G or T command was used, BX:CX must 
be reset before using the W command without parameters. 


If the W command is given with only an address, the file is written to the 
disk file beginning at that address. 


Note: If a file is loaded and modified, the name, length, and starting 
address are set correctly to save the modified file, as long as the length 
has not changed. 


If all parameters are used, the file is written to the drive specified (the 
drive designation is numeric, where A: = 0, B: = 1, C: = 2, D: = 3). DEBUG 
writes the file beginning at the logical sector number specified by the 

first sector and continues until the number of sectors specified in the 
second sector have been written. 


WARNING 


Writing to absolute sectors is EXTREMELY dangerous because the process 
bypasses the file handler. 


Example 
WCS:100 1 37 2B 
DEBUG writes out the contents of memory, beginning with the address 
CS:100 to the disk in Drive B:. The data written out starts in logical 


disk record number 37H and consists of 2BH records. When the write is 
complete, DEBUG displays the DEBUG prompt. 
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COMMAND SUMMARY 


Command 


Assemble 


Compare 


Dump 


Enter 


Fill 


Move 


Name 


Output 


Format and Purpose 


A [ address ] 
Assembles 8086/8087/8088 assembly mnemonics directly into 
sequential addresses starting at address specified or CS:100. 


C range address 
Compares byte values in memory range with values starting at 
address. 


D[ range ] 

D[ address [L va/ue]] 

Dumps memory contents in specified range or at current location, if 
not specified. 


E address [ //st] 
Allows you to enter values into memory locations and to step 
through memory (forward or backward) one byte at a time. 


F range list 
Fills a range of memory with list of values or repeats list if list 
is exhausted. 


G [ =address ] [ address ...] 
Executes program in memory with optional breakpoints specified. 


H value value 
Performs hexadecimal addition and subtraction and displays answers. 


| portaddress 
Displays value read from port specified by portaddress. 


L [ address [drive sector sector ]] 
Loads file previously named or, if sector parameters are used, 
loads absolute sectors. 


M range address 
Moves a range of memory locations to a starting address of address. 


N[d: ][ path] £//ename [ .ext ] [[ d: ][ path] £//ename [ .ext ]] 
Names a file on a certain drive to be used for a subsequent Load 
command and sets optional program parameters. 


O portaddress byte 
Sends the byte specified to the port specified in portaddress. 
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Command Format and Purpose 
Proceed P [ =address ] [ va/ue ] 
Executes subroutines and procedures as single instructions. 
Quit Q 
Ends a DEBUG session. 
Register R[ regi stername ] 
Displays registername specified or all registers if none is named. 
Also displays flags. 
Search S range /ist 
Searches for sequential values in list in the specified range of 
memory. 
Trace T [ =address ] [ va/ue ] 


Unassemble 


Write 


Table 10-3 


Executes single statements for examining registers and memory 
locations. 


U[ address [L va/ue ]] 
U[ range ] 
Unassembles instructions from an executable file. 


W[ address [drive sector sector ]] 


Writes absolute sectors to disk. Can destroy files -- refer to 
section on Write command. 


DEBUG Command Summary 
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ERROR MESSAGES 


During the DEBUG session, you may receive any of the following error messages. 
Each error ends the current DEBUG command, but does not exit DEBUG itself. 


BF 
Stands for Bad Flag. You attempted to alter a flag, but the characters 
entered were not one of the acceptable pairs of flag values. See the 
Register command for the list of acceptable flag entries. 

BP 
Stands for Too Many Breakpoints. You specified more than ten breakpoints 
as parameters to the G command. Reenter the Go command with ten or fewer 
breakpoints. 

BR 
Stands for Bad Register. You entered the R command with an invalid 
register name. See the Register command for the list of valid register 
names. 

DF 


Stands for Double Flag. You entered two values for one flag. You may 
specify a flag value only once per RF command. 
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APPENDIX A 
ANSI ESCAPE SEQUENCES 


This appendix describes how the ANSI escape sequences are used in MS-DOS. An 
ANSI escape sequence is a series of characters, beginning with the Escape 
character, used to define functions to MS-DOS. You can use these escape 
sequences to affect cursor movement, erase information from the screen display, 
set the graphics mode, and reassign keys. 


You may execute ANSI escape sequences at the MS-DOS command line with the 
PROMPT command. You may also create them in a file and then issue them using 
the TYPE command. You may also include escape sequences in your GWBASIC or 
Assembly language programs. 
INSTALLING THE ANSI.SYS DRIVER 
Before issuing any ANSI escape sequence, you must load the special device 
driver ANSI.SYS. To do this, create a CONFIG.SYS file in the root directory of 
the drive MS-DOS is booted from and type the following command in it: 

DEVICE = [d: ][ path] ANSI.SYS 
You may specify a drive and path for ANSI.SYS if it is not located in the root 
directory of the default drive. See Chapter 7 for additional information on 
creating the CONFIG.SYS file. 
When you restart MS-DOS, the ANSI.SYS extended screen and keyboard control 
driver wil be loaded into memory, so that you can use the escape sequences. 


ANSI ESCAPE SEQUENCE SYNTAX 


Whether you enter it from the command line, from a file, or as part of an 
application program, each ANSI escape sequence has the same basic syntax: 


ESC [ parameters command 
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ESC is the actual 1-byte code for Escape, not the characters ESC. For example, 
if you are entering the escape sequence at the command line using PROMPT, the 
ESC code is $E. In GWBASIC, ESC is CHR$(27); in ASCII, ESC is 1BH. 


The ESC code is always followed by the [ character. 

In the following examples, # represents a numeric parameter. Replace # with a 
decimal number using ASCII digits. If you supply no value or a value of zero, 
the default value is used. 

Following the numeric parameters, enter an alphabetic character or string 


representing the specific ANSI command you want to use. 


ISSUING AN ESCAPE SEQUENCE 


Two methods are commonly used to issue ANSI escape sequences. You can execute 


the sequence at the MS-DOS command line using PROMPT, or you can create a file 
containing the escape sequence and then use the TYPE command to execute it. 
For example, if you are using the numeric keypad a lot, you might want to 
reassign the * key so that it becomes a more convenient / (division symbol) 
key. 


1. Command Line Method. At the MS-DOS prompt, type: 
prompt $e[96;47p 


With this method, $e is the code for ESC. 96 is the ASCII code for the 

* key and 47 is the ASCII code for the / key. When you press RETURN, the 
escape sequence is issued. Whenever you press the * key, the / symbol is 
displayed. 


You will notice, however, that the MS-DOS prompt has disappeared. After 
using the command line method to issue ANSI escape sequences, you can reset 
the prompt by typing PROMPT with no parameters. Or you can include your 
MS-DOS prompt parameters in the same command with your ANSI escape 
sequence. For example, to issue the reassignment sequence above while 
preserving the default MS-DOS prompt, type: 


prompt $n$g$e[96;47p 
See the PROMPT command in Chapter 5 for additional information. 


2. File Creation Method. You can create a file containing the escape 
sequence. Then use the TYPE command to execute it. 


In the following examples of ANSI escape sequences, only the basic syntax 
is given. You may choose either method to issue the command. 
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CURSOR CONTROL FUNCTIONS 
The following escape sequences affect the cursor position on the screen. 
Cursor Position (CUP) 

ESC [ #;#H 


The CUP sequence moves the cursor to the position specified by the 


parameters. The first parameter (#) specifies the line number, and the 
second specifies the column number. The default value is 1. If no 


parameters are specified, the cursor is moved to the home position. 


Cursor Up (CUU) 
ESC [#A 
This sequence moves the cursor up one or more lines without changing 
columns. 


The value of # determines the number of lines moved. The default 
value is 1. The CUU sequence is ignored if the cursor is already on the 
top line. 


Cursor Down (CUD) 


ESC [#B 


columns. The value of # determines the number of lines moved. The default 
value is 1. 


This sequence moves the cursor down one or more lines without changing 
The CUD sequence is ignored if the cursor is already on the 
bottom line. 


Cursor Forward (CUF) 


ESC [4C 


The CUF sequence moves the cursor forward one column without changing 

lines. The value of # determines the number of columns moved. The default 
value is 1. The CUF sequence is ignored if the cursor is already in the 
far right column. 
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Cursor Backward (CUB) 
ESC [4D 
This sequence moves the cursor back one column without changing lines. 


The 
value of * determines the number of columns moved. The default value is 

1. The CUB sequence is ignored if the cursor is already in the far left 
column. 


Cursor Position Report (CPR) 
ESC [#;#R 


The CPR sequence reports current cursor position through the standard input 
device. 


The first parameter specifies the current line and the second 
parameter specifies the current column. 


Device Status Report (DSR) 
ESC [6n 


The DSR sequence reports current cursor position through the console 

driver, which outputs a Cursor Position Report sequence (see CPR above) 
Horizontal and Vertical Position (HVP) 

ESC [#;#f 


Moves the cursor to the position specified by the parameters. 


The first 
parameter specifies the line number, and the second specifies the column 
number. The default value is 1. 


If no parameters are specified, the 
cursor is moved to the home position. 


Save Cursor Position (SCP) 
ESC [s 


The current cursor position is saved. This cursor position can be restored 
with the Restore Cursor Position sequence (see RCP below). 


Restore Cursor Position (RCP) 
ESC [u 


This sequence restores the cursor position to the value it had when the 
console driver received the Save Cursor Position (SCP) sequence. 
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ERASE FUNCTIONS 


The following escape sequences allow you to erase text from the screen. 
Erase Display (ED) 
ESC [2J 


The ED sequence erases the screen and moves the cursor to the home 
position. 


Erase Line (EL) 


ESC [K 


This sequence erases from the cursor to the end of the line (including the 
cursor position). 


MODES OF OPERATION 
The following escape sequences are used to control screen graphics. 


Set Graphics Rendition (SGR) 
ESC [$;. «m 


The SGR escape sequence invokes the graphic functions specified by the 
parameters described below in Table A-1. 


The graphic functions remain 
until the next occurrence of an SGR escape sequence. For example: 
PROMPT $e[7m$n$g$e[m 


Creates a standard prompt ($n$g) but sets it in reverse video 
mode. All other text remains in normal video mode. 


PROMPT $p$g$e[33; 44m 


On a color monitor, this example sets the prompt to display the 


current directory ($p$g) and displays the prompt in red against a 
blue background. 
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Parameter Function 


0 All attributes OFF 
1 Bold ON 

4 Underscore ON 

(monochrome displays only) 

9 Blink ON 

7 Reverse video ON 
8 Concealed ON 

30 Black foreground 
31 Red foreground 

32 Green foreground 
33 Yellow foreground 
34 Blue foreground 

35 Magenta foreground 
36 Cyan foreground 

37 White foreground 
40 Black background 
41 Red background 
42 Green background 
43 Yellow background 
4d Blue background 
45 Magenta background 
46 Cyan background 
47 White background 


Table A-1 Escape Parameters for Set 
Graphics Rendition (SGR) 
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Set Mode (SM) 

The following escape sequences set the screen mode: 
ESC [=#h 

or 

ESC [=h 

or 

ESC [=0h 

or 

ESC [?7h 


The Set Mode escape sequence changes the screen width or type to one of the 
parameters listed in the table below. 


Parameter Function 


0 40 x 25 black and white 

1 40 x 25 color 

2 80 x 25 black and white 

3 80 x 25 color 

4 320 x 200 color 

5 320 x 200 black and white 
6 640 x 200 black and white 
7 Wrap at end of line 


Table A-2 Escape Parameters for 
Set Mode (SM) 
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Reset Mode (RM) 
The following escape sequences reset the screen mode: 
ESC [=#| 
or 


ESC [=| 


or 
ESC [?71 
The parameters for Reset Mode are the same as for Set Mode (see Table A-2), 
except that parameter 7 will erase the wrap at end-of-line mode. 

KEYBOARD REASSIGNMENT 


The following escape sequences are used to redefine the meaning of keys on your 
keyboard. 


ESC [=#;#;...#p 

or 

ESC ["string"p 

or 

ESC [#;"string":#:#"string":#p 


Note: The final code in the control sequence (p) is one reserved for private 
use by the ANSI 3.64-1979 standard. 


The first ASCII code in the control sequence defines which code is being 
changed. The remaining numbers define the sequence of ASCII codes generated 
when this key is pressed. 


There is one exception. If the first code in the sequence is zero (NUL), then 


the first and second codes make up an extended ASCII redefinition. Examples 
follow. 
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iy 


Reassign the Q and q keys to the A and a keys (and vice versa): 


ESC [65;81p 
ESC [97; 113p 
ESC [81;65p 
ESC [113;97p 


A becomes Q 
a becomes q 
Q becomes A 


q becomes a 


Reassign the F10 key so that it issues a DIR command followed by a carriage 


return: 


ESC [0;68; "DIR"; 13p 


0;68 is the extended ASCII code for the F10 key; 13 decimal is a carriage 


return. 
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APPENDIX B 
MS-DOS MESSAGE DIRECTORY 


This appendix contains an alphabetical listing of the messages that MS-DOS 
displays when it is unable to perform a requested task. 


Most messages refer to problems in reading from or writing to devices like disk 
drives or printers. These are called device errors. 


Some messages refer to problems with a disk or disk drive. These are called 
disk errors. 


Other messages are related to a specific MS-DOS command. The name of the 
command is included in the explanation which follows it. 


DEVICE ERRORS 


Device error messages all take the same form. They are displayed as: 


type error reading device 
Abort, Retry, Ignore? 


Or 


type error writing dev/ce 
Abort, Retry, Ignore? 


In each of these messages, device is the name of the device involved, such as 
A: or LPT1. Type is replaced by one of the following: 


Bad call format Non-DOS disk 

Bad command Not ready 

Bad unit Read fault 

Data Sector not found 
Disk Seek 

FCB unavailable Sharing violation 
General failure Write fault 

Lock violation Write protect 

No paper 
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When you receive one of these messages, you have a choice of actions. Type one 
of the following letters: 


A Abort ends the program that requested the read or write. 

R Retry causes your computer to retry the operation after you correct the 
problem. 

I Ignore causes your computer to ignore the problem and attempt to 


continue the program. If you choose this option, you may lose some 
data. Be careful. 


Device error messages are listed alphabetically in the following list of MS-DOS 
messages. 

DISK ERRORS 

If a read or write error occurs on one of the disk drives during a command 
process or while running an application program, MS-DOS displays an error 


message in the following format: 


type error while I/O reading on drive d: 
Abort, Retry, Ignore: 


or 


type error while I/O writing on drive d: 
Abort, Retry, Ignore: 


In this format, d: is the drive on which the problem occurred. Type may be one 
of the following: 


Bad call format No paper 

Bad command Not ready 

Bad unit Read fault 

Data Sector not found 
Disk Seek 

General failure Write fault 
Non-DOS disk Write protect 


When you receive one of these messages, you have the choice of the A (Abort), R 
(Retry) or I (Ignore) options described above. 
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MESSAGES 


Abort edit (Y/N)? 
MS-DOS displays this message when you select the Q (Quit) command in 
EDLIN. Typing Y (YES) lets you exit EDLIN without saving any editing 
changes. Typing N (no) lets you continue editing the file. 


About to generate .EXE file 

Change diskette in drive d: and press ENTER 
This message is displayed in MS-LINK before the .EXE file is written (if 
you specify the /P option). 


Access denied | 
This message is displayed if executing your command violates the access 
mode of a file, directory, or device, for example, when you attempt to 
write to a read-only file. 


All files cancelled by operator 
MS-DOS displays this message when you specify the /T option with the PRINT 
command. 


All specified files are contiguous 
This is an informational message displayed following the CHKDSK command if 
all files specified are written sequentially on the disk without 
fragmentation. No action is required. 


Allocation error in file, size adjusted 
MS-DOS displays this message following the CHKDSK command if the File 
Allocation Table contains an invalid sector number. If you specified the 
/F option, the file is truncated at the end of the last valid sector. 
CHKDSK has automatically performed the only remedy available at this 
point. If you did not specify the /F option, you should use the CHKDSK/F 
command before continuing. 


Amount read less than size in header 
Displayed with the EXE2BIN command if the program portion of the file is 
smaller than specified in the file header. You should recompile the 
program. 


Are you sure (Y/N)? 
MS-DOS displays this message if you try to delete all files in the working 
drive or directory (*.*). Type Y (yes) or N (no). 


Array element size mismatch 
MS-LINK displays this message when a communal array is declared with 
different array element sizes (for example, once as a character array and 
once as a real array). 


Attempt to access data outside of segment bounds 


The object file specified with MS-LINK is invalid. Review the object file 
for segmentation violations or invalid references. 
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Attempt to put segment xxxxxx in more than one group in file xxxxxx 
MS-LINK displays this message when a segment is declared as part of two 
different groups. 


Attempted write protect violation 
This message appears following the FORMAT command if the disk you are 
attempting to format is write-protected. 


Backup file sequence error 
This message is displayed with the RESTORE command if the backup disks are 
inserted in improper order. For example, if a file to be restored is 
backed up on more than one disk and you did not insert the disk with the 
first part of the file. 


Bad call format 
See the Device Errors and Disk Errors sections in this Appendix. A request 
header of incorrect length was passed to a device driver. 


Bad command 
See the Device Errors and Disk Errors sections in this Appendix. A device 
driver has issued an invalid command to the named device. 


Bad command or filename 
The command or filename you entered is not valid. Check the spelling and 
retry. MS-DOS also displays this message if it cannot locate the command 
in the current drive or directory. 


Bad internal reloc table 
This message indicates an internal MS-LINK error. Contact your dealer. 


Bad file 
One of the files you specified is defective. 


Bad or missing Command Interpreter 
MS-DOS cannot find COMMAND.COM on the disk. The file is either missing 
from the root directory or the file is invalid. Restart the system, and if 
the error occurs again, copy COMMAND.COM from your MS-DOS Master Disk to 
the disk used to start MS-DOS. 


Bad or missing f//ename 
MS-DOS displays this message at startup if you specified an invalid device 
in the CONFIG.SYS file. Check the DEVICE statement for accuracy. 


Bad unit 
See the Device Errors and Disk Errors sections in this Appendix. An 
invalid subunit number has been sent to a disk device driver. 


Bad tracks found at start of partition 

Partition size adjusted 
During the FDISK command, bad tracks were encountered in the area of the 
fixed disk reserved for MS-DOS. No action is required. 
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Batch file missing 
MS-DOS displays this message when it cannot find the batch file it was 
processing. Check to see if the file was erased or renamed during 


processing. 

BF 
Stands for Bad Flag. You attempted to alter a flag with the DEBUG command, 
but the characters entered were not an acceptable pair of flag values. 

BP 
Stands for Breakpoints. DEBUG displays this message when more than ten 
breakpoints are specified as parameters to the G (Go) command. 

BR 


Stands for Bad register. You entered an invalid register name with the 
DEBUG R (Register) command. 


Buffer size adjusted 
The buffer size specified in the VDISK.SYS statement in your CONFIG.SYS 
file has been adjusted to fit system requirements. No action is required. 


Cannot CHDIR to 7 //ename 

Tree past this point not processed 
The CHKDSK command was unable to go to the specified directory. Any 
subdirectories below this directory will not be verified. 


Cannot CHDIR to root 
Processing cannot continue 


The disk you are checking with CHKDSK is faulty. Restart MS-DOS and try 
RECOVER. 


Cannot CHKDSK a network drive 
MS-DOS cannot check a drive that is redirected as a network drive. This 
includes any drive on your computer being shared by the network. 


Cannot CHKDSK a SUBSTed or ASSIGNed drive 
The SUBST and ASSIGN commands hide the disk and device information required 
by CHKDSK. 


Cannot DISKCOMP to or from a network drive 
MS-DOS cannot use DISKCOMP to compare files on a drive redirected as a 
network drive. Use COMP *.* instead. 


Cannot DISKCOPY to or from a network drive 
MS-DOS cannot use DISKCOPY to compare files on a drive redirected as a 
network drive. Use COPY *.* instead. 


Cannot do binary reads from a device 


You have tried to use the COPY /B option with the name of a device. Place 
an /A option after the device name to copy in ASCII mode. 
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Cannot edit .BAK file -- rename file 
You have tried to use EDLIN to edit a file that has a .BAK extension. 
Either edit the more up-to-date version of the file, or rename the .BAK 
file before attempting to edit it. 


Cannot find file Ob/ect-f | /ename 

Change diskette and press ENTER 
MS-LINK could not find the specified object module on the disk. Insert the 
correct disk. 


Cannot find file L/brary-fi/ename 

Enter new file spec: 
MS-LINK could not find the specified library on the specified drive. Type 
a new file specification. 


Cannot find system files 
The hidden files IO.SYS and MSDOS.SYS could not be found by the FORMAT /S 
or SYS command. 


Cannot FORMAT an ASSIGNed drive 
You cannot format a disk drive which has been reassigned. Type ASSIGN to 
clear all assignments and rerun the FORMAT command. 


Cannot FORMAT a network drive 
MS-DOS cannot format a drive redirected as a network drive. 


Cannot FORMAT an SUBSTed drive 
You cannot format a disk drive which has been reassigned using the SUBST 
command. Use the SUBST /D command to clear all reassignments and rerun the 
FORMAT command. 


Cannot JOIN to a network drive 
The JOIN command cannot join a local drive to a network drive. 


Cannot LABEL a network drive 
MS-DOS cannot create or change the volume label on a drive redirected as a 
network drive. 


Cannot load COMMAND, system halted 
MS-DOS was unable to reload the command processor after it was 
overwritten. The COMMAND.COM file was not found in the drive and path 
specified by the COMSPEC statement in your CONFIG.SYS file. Restart 
MS-DOS. 


Cannot nest response file 
The automatic response files used with MS-LINK cannot be nested. Check 
your response file for an @filename statement. 


Cannot open f//ename 


The PRINT command cannot find the specified file. Check the accuracy of 
the file specification. 
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Cannot open list file 
MS-LINK cannot create the list file because the specified disk is full. 
Delete some files or use another disk. 


Cannot open overlay 
The directory or disk used by MS-LINK is full. Insert another disk or 
delete files. 


Cannot open response file: f //ename 
MS-LINK cannot find the automatic response file specified. Check the drive 
and path specified. 


Cannot open run file 
MS-LINK cannot create the run file because the specified disk is full. 
Delete some files or insert another disk. 


Cannot RECOVER a network drive 
You cannot RECOVER files on a drive redirected as a network drive. 


Cannot reopen list file 
The disk containing the MS-LINK list file was not replaced. Restart 
MS-LINK. 


Cannot SUBST to a network drive 
You cannot use the SUBST command to substitute a drive for a network path 
or network drive. 


Cannot SYS to a. network drive 
You cannot use the SYS command to transfer the MS-DOS system files to a 
drive redirected as a network drive. 


CHDIR..failed trying alternate method 
The CHKDSK command was unable to return to a parent directory. It returns 
to the root and attempts to find the directory by traveling down. 


Configuration too large 
The value specified for the BUFFERS or FILES commands in the CONFIG.SYS 
file does not leave enough room to load MS-DOS. Restart MS-DOS from 
another disk and reduce the value. 


Content of destination lost before copy 
A file used as a source file by the COPY command has been overwritten prior 
to completion of the copy. For example, COPY A.TXT+B.TXT B.TXT produces 
this message. 


Convert lost chains to files (Y/N)? 
The CHKDSK command located lost blocks when checking the disk. If you type 
Y (YES), CHKDSK will create a directory entry with the filename 
FILEnnnn.CHK. If you type N (NO), CHKDSK frees the lost blocks so they can 
be reallocated. 


MS-DOS Message Directory | B-7 


Copy not completed 
The DISKCOPY command could not copy the entire disk. Rerun the command. 


Current drive is no longer valid 
While attempting to read the current drive, COMMAND.COM found that the 
drive is no longer valid. Change your current drive to a valid drive. 


Data error 
See the Device Errors and Disk Errors sections in this Appendix. Data 
could not be read/written correctly because of a faulty disk. Restart 
MS-DOS and try RECOVER. 


Data left in f£ //ename 
One of the files in a file comparison has reached end-of-file, but the 
other file still has uncompared data left. 


DF 
Stands for Double flag. The DEBUG program displays this message to 
indicate a double flag. Only one flag may be specified per RF command. 


Directory entries adjusted 
VDISK.SYS adjusted the number of directory entries specified in the 
CONFIG.SYS file to accommodate system requirements. 


Directory is joined 
The CHKDSK command will not process directories that are joined. 


Directory not empty 


The JOIN command displays this message; you can only join onto an empty 
directory. 


Disk error 
See the Device Errors and Disk Errors sections in this Appendix. An error 
has occurred reading from or writing to a disk. Attempt to correct the 
problem and retry this operation. 


Disk error writing FAT 
An error occurred while CHKDSK was trying to update the File Allocation 
Table. Copy the disk and retry the procedure. If this does not work, try 
to RECOVER the disk. If this does not work, the disk is irreparably 
damaged. 


Disk full. Edits lost 
EDLIN was not able to save your file due to lack of disk space. 


Disk full -- write not completed 
After issuing the EDLIN E (End) command, the disk did not contain enough 
free space for your file. EDLIN returned you to the MS-DOS command line, 
but a damaged portion of your file may have been written to disk. This is 
an unrecoverable error. Delete the file and restart the editing session. 
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Disk not compatible 
You have specified a disk with the FORMAT command that is not compatible 
with the MS-DOS device drivers. 


Diskette/Drive not compatible 
The destination disk or drive specified with the DISKCOMP or DISKCOPY 
command is different than the source disk or drive. For example, you 
cannot DISKCOPY a double-sided disk to a single-sided disk. Use the COPY 
command. 


Disk unsuitable for system drive 
The FORMAT program detected a defective track on the disk where the system 
files should reside. Use this disk for data storage only. 


Divide overflow 
A program has attempted to divide by zero or a logic error caused an 
internal malfunction. Correct the error and rerun the program. 


Drive types or diskette types not compatible 
The source and target disks or drives specified with the DISKCOPY or 
DISKCOMP commands are not compatible. 


Drive not ready 
If this message appears while PRINT attempts a disk access, PRINT keeps 
trying until the drive is ready. Any other error cancels the current file 
and prints an error message on your printer. 


Duplicate filename or file not found 
An attempt has been made to RENAME a file with a filename that already 
exists on the destination disk, or the file to be renamed could not be 
found on the specified disk drive. 


End of input file 
EDLIN displays this message when the entire file is read. If the file is 
read in sections, the last section of the file is in memory. 


Enter primary file name 
The COMP command prompts you with this message for the first of two files 
to be compared. 


Enter 2nd file name or drive id 
The COMP command prompts you with this message for the second of two files 
to be compared. 


Entry error 
You have incorrectly entered an EDLIN command. Reenter the command. 


Entry has a bad attribute 

(or link or size) 
CHKDSK displays this message preceded by either one or two periods, which 
indicate which subdirectory is invalid. If you specify the /F option, 
CHKDSK will attempt to correct the error. 
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Error in .EXE file 
The .EXE file you asked MS-DOS to load has an invalid internal format. 


Error loading operating system 
MS-DOS encountered a disk error while attempting to load the system from 
the fixed disk. Restart the system. 


Error reading fixed disk 
The FDISK program was unable to read the startup record of the fixed disk. 
Rerun FDISK. 


Error writing fixed disk 
The FDISK program was unable to write the startup record of the fixed 
disk. Rerun FDISK. 


Error writing to device 
Too much data was sent to a device; MS-DOS was unable to write the data to 
the specified device. 


Errors found, F parameter not specified 

Corrections will not be written to disk 
The CHKDSK command found errors on the disk. It continues processing, but 
does not correct the errors. Run CHKDSK with the /F option. 


Errors on list device indicate that 

it may be off-line. Please check 
The PRINT command displays this message when the device being used for 
background printing is off-line. Turn on the printer. 


EXEC failure 
Either MS-DOS encountered an error when reading a command or the FILES 
command in the CONFIG.SYS file is set too low. 


FCB unavailable 
See the Device Errors section in this Appendix. You tried to open too many 
files at one time with the SHARE command loaded. Specify additional file 
control blocks in the FCBS command in your CONFIG.SYS file. 


File allocation table bad 
See the Disk Errors section in this Appendix. The disk may be defective. 
Run CHKDSK to check the disk. 


File cannot be converted 
The input file specified with the EXE2BIN command is not in the correct 
format. 


File cannnot be copied onto itself 
A request was made to COPY a file and place a copy with the same filename 
in the same directory. Either change the filename given to the copy or put 
it on another disk or directory. 
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File creation error 
An unsuccessful attempt was made to add a new file to the directory. Check 
to see whether the file already exists in the directory or run CHKDSK to 
determine the cause of the error. 


File is READ-ONLY 
The file you specified with EDLIN is read-only. Use the ATTRIB command to 
change the file to read- write. 


File not found 
The file named in a command does not exist on the disk in the specified 
drive. Check your filename entry or drive selection and try again. 


File not in print queue 
The file you want to cancel with the PRINT command is not in the print 
queue. It may already have been printed. 


File sharing conflict 
The COMP command is unable to compare two files because one is in use. 
Retry the command. 


filename cancelled by operator 
This message is printed on the line printer when you specify the /T option 
with the PRINT command. 


filename contains non-contiguous blocks 
The filename specified in CHKDSK is not allocated contiguously on the 
disk. If you specify the /F option, CHKDSK will fix this error. 


filename file not found 
The PRINT command cannot find a file in the print queue. You may have 
switched disks before the file began printing. Reissue the PRINT command 
for that filename. 


filename is currently being printed 
The filename specified in the PRINT command is being printed. 


filename is in queue 
The filename specified in the PRINT command is waiting to be printed. 


Filename is cross linked on cluster 
CHKDSK issues this message to indicate you have two files cross-linked. 
Make a copy of each file, and then delete the files that are cross-linked. 


Filename must be specified 
You did not type a filename when you started EDLIN. Type EDLIN and then a 
filename. 


Files are different sizes 


The sizes of files specified by the COMP command are different sizes. No 
comparison can be made. 
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Files were backed up date 
This message is displayed by the RESTORE command to tell you the date the 
files on this disk were backed up. 


FIND: File not found f//ename 
The file you specified in the FIND command does not exist on the drive. 
Check your filename entry or drive selection and try again. 


FIND: Invalid number of parameters 
You omitted an option when specifying a FIND command. Reenter the command. 


FIND: Invalid parameter opt/on-name 
An invalid option was entered with the FIND command. Reenter the command 
with a correct option. 


FIND: Read error in f//ename 
An error occurred when FIND tried to read the file specified in the 
command. Retry the command after correcting an obvious problem (disk drive 
door open, no disk, and so on). Try RECOVER. 


FIND: Syntax error 
You entered an illegal string with the FIND command.  Reenter the correct 
string. 


First cluster number is invalid, entry truncated 
CHKDSK found an invalid pointer to the data area in the filename preceding 
this message. If /F was specified, the file is truncated to zero length. 
This is an irrecoverable error. 


Fixed Backup device is full 
The target device for the BACKUP command is full. 


Fixups needed -- base segment (hex:) 
The source (.EXE) file specified in the EXE2BIN command contained 
information indicating that a load segment is required for the file. 
Specify the absolute segment address at which the finished module is to be 
located. 


FOR cannot be nested 
Rewrite the FOR commands in your batch file to avoid nesting. 


Format failure 
A disk error was encountered while attempting to FORMAT a disk. An 
explanatory message usually follows. 


Formatting while copying 
The target disk specified in the DISKCOPY command is unformatted or 
contains unformatted tracks. 


General failure 
See the Device Errors and Disk Errors sections in this Appendix. An error 
other than the ones listed here has occurred. Try the R (Retry) option, 
then A (Abort) if the error recurs. 
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Has invalid cluster, file truncated 
CHKDSK found an invalid pointer to the data area in the filename preceding 
this message. If /F was specified, the file is truncated at the last valid 
data block. 


Illegal device name 
A device name was specified in the MODE command other than the reserved 
device names (COM1, COMO, LPT1, LPT2, LPT3) or a device name specified in 
your CONFIG.SYS file. Retry the command with a valid device name. 


Incompatible system size 
This message is displayed by the SYS command if the system files IO.SYS and 
MSDOS.SYS occupy more space on the source disk than is available on the 
target disk. 


Incorrect DOS version 
Many MS-DOS commands (like CHKDSK, FIND, FORMAT, PRINT, and SYS) will only 
run under the exact version of MS-DOS for which they were configured. Use 
the same version of MS-DOS. 


Incorrect parameter 
One of the options you specified with the SHARE command is invalid. 


Insert disk with COMMAND.COM in drive A 

and strike any key when ready 
MS-DOS is attempting to reload the command processor, but cannot locate 
COMMAND.COM in the drive and path specified in the COMSPEC statement in 
your CONFIG.SYS file. Insert the MS-DOS disk in the specified drive and 
press any key to continue. 


Insert diskette for drive d: 

and strike any key when ready 
When copying and formatting, insert a disk in the appropriate drive and 
press any key to continue. 


Insert diskette with batch file 

and press any key when ready 
The disk containing the batch file you are running is not in the drive 
originally specified.  Reinsert the disk containing the batch file in the 
appropriate drive and press any key to continue. 


Insert DOS diskette in d: 

and press any key when ready 
You have specified the /S option with the FORMAT command, but the disk in 
the default drive does not contain the MS-DOS system files. Insert a 
system disk in the drive indicated and press any key to continue. 


Insert new diskette for drive d: 

and press ENTER when ready 
The FORMAT command prompts you to insert the disk to be formatted in the 
drive specified. | 
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Insert system disk in d: 

and press any key when ready 
You have entered the SYS command, but the disk in the default drive does 
not contain the MS-DOS system files. Insert a system disk in the drive 
indicated and press any key to continue. 


Insufficient disk space 
There is not enough free space on the disk to save the file or perform the 
MS-DOS operation. Use another disk. You may have lost some data as a 
result of the operation that caused this message to appear. 


Insufficient memory 
There is not enough memory available to perform the specified operation. 
Restart the system and remove memory-resident programs (like PRINT, 
GRAPHICS, and VDISK) to free additional memory. 


Insufficient memory for system transfer 
This message is displayed after the FORMAT or SYS command when there is not 
enough memory to transfer the MS-DOS system files. Restart the system and 
remove memory-resident programs (like PRINT, GRAPHICS, and VDISK) to free 
additional memory. 


Insufficient room in root directory 

Erase files in root and repeat CHKDSK 
CHKDSK cannot create an entry in the root directory for saving lost chains 
as files because the root directory is full. You should copy some files 
from the root directory to another disk, then enter another CHKDSK command. 


Insufficient space on disk 
DEBUG displays this command when writing to a disk with insufficient free 
space to hold the file. Insert another diskette and reissue the command. 


Insufficient stack space 
There is not enough memory available to run MS-LINK. Restart the system 
and remove memory-resident programs (like PRINT, GRAPHICS, and VDISK) to 
free additional memory. 


Intermediate file error during pipe 
The pipe operation makes use of temporary files on disk that are 
automatically deleted after the piping process is finished. An error 
occurred in one of these files. 


Invalid baud rate specified 
The baud rate entered with the MODE command is incorrect. Allowable rates 
are 110, 150, 300, 600, 1200, 4800, and 9600. 


Invalid COMMAND.COM in drive d: 
When MS-DOS attempted to reload COMMAND.COM, the version on the disk was 
found to be an incorrect version. Insert a disk with the proper version of 
COMMAND.COM and press any key to continue. 
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Invalid country code 
You have specified an incorrect country code with the SELECT command or in 
the CONFIG.SYS file. 


Invalid current directory 

Processing cannot continue 
CHKDSK has found an error in the current directory. Restart your computer 
and rerun CHKDSK. 


Invalid date 
You have tried to enter an invalid date. Review the syntax for the DATE 
command and try again. 


Invalid device 
The device specified with the CITY command is incorrect. Allowable names 
are AUX, CON, NUL, PRN, or a device driver specified in your CONFIG.SYS 
file. 


Invalid directory 
One of the directories in the path you specified does not exist. Retry the 
command using a valid directory. 


Invalid disk change 
The disk in the specified drive was changed while files were still open. 
Reinsert the correct disk. 


Invalid drive in search path 
One of the drive designators specified with the PATH command is incorrect. 
(MS-DOS displays this message when attempting to locate a command or batch 
file, not when you enter the PATH command.) 


Invalid drive name or filename 
You did not specify a valid drive or filename when you started EDLIN or 
issued the RECOVER command. Check your entry and try again. 


Invalid drive specification 
You have entered the wrong drive parameter on the command line. Refer to 
the syntax of the command you have selected and try again. With some 
commands, an explanatory message is also displayed. 


Invalid format file 
MS-LINK has detected an error in one of the library files specified. 
Restore the file from your backup disk and restart MS-LINK. 


Invalid media or track O bad -- disk unusable 
The FORMAT command has detected an error in track O of the target disk. 
Use another disk. 


Invalid number of parameters 


You have specified the wrong number of options in the command line. Retry 
the command with the correct syntax. 
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Invalid object module 
The input file specified with MS-LINK is not in the correct format or 
errors occurred during compilation. Recompile the module and restart 
MS-LINK. 


Invalid parameter 
You have entered an incorrect parameter. Refer to the syntax of the 
command you have selected and try again. 


Invalid parameters 
No parameters or incorrect parameters were entered with the MODE command. 
Retry the command. 


Invalid partition table 
MS-DOS displays this message when attempting to start from a fixed disk 
with invalid partition information. Start MS-DOS from a floppy disk and 
correct the fixed disk problem using FDISK. 


Invalid path 
An error was detected in the directory structure when running the BACKUP, 
RESTORE, or TREE commands. Run CHKDSK to determine the error. 


Invalid path, not directory, or directory not empty 
The RMDIR command cannot remove the directory specified because one of the 
names specified in the path is incorrect, does not exist, or still contains 
files. Correct the entry in the command line or delete all files and 
subdirectories from the directory you want to delete. 


Invalid path or file name 
You specified an incorrect directory or filename with the ATTRIB or COPY 
command. Correct the entry and retry. 


Invalid subdirectory 
The subdirectory contains invalid information. Rerun the CHKDSK command 
with the /V option for further information. Use the CHKDSK /F command to 
correct the error. 


Invalid swi tch 
The option switch specified on the preceding line is not a valid option for 
MS-LINK. 


Invalid time 
You have entered an invalid time or the wrong punctuation mark. Review the 
syntax for the TIME command and try again. 


Label not found 
The batch command you are running names a label that does not exist in the 
batch file. Edit the batch file. 


Last backup target not inserted 


The BACKUP /A command was issued, but the removable target disk was not the 
last disk in the backup sequence. 
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Line too long 
During the EDLIN R (Replace) command, the string given as the replacement 
caused the line to expand beyond 253 characters. EDLIN ended the Replace 
command. Divide the line into two shorter lines and try again. 


List output is not assigned to a device 
You have specified an invalid device with the PRINT command. Specify a 
valid list device and retry the command. 


Lock violation 
See the Device Errors section in this Appendix. This message is displayed 
only when the SHARE command is loaded and the file you attempt to access is 
locked by someone else. Retry the command by typing R (Retry). If the 
problem still exists, type A (Abort) and retry later. 


Memory allocation error 

Cannot load COMMAND, system hal ted 
A program error has destroyed the area where MS-DOS keeps track of 
available memory. Restart MS-DOS. If the error persists, make a new copy 
of the MS-DOS disk from your Master Disk. 


Missing operating system 
MS-DOS attempted to start from the fixed disk and found that the MS-DOS 
partition was " bootable’ but contained no system files. Start MS-DOS from 
the floppy drive and use the SYS command to transfer the system files to 
the fixed disk. 


~-More-- 


MS-DOS displays this message with the MORE command to indicate there is 
additional information in the file. Press any key to view the next screen. 


Must specify destination line number 
You have not specified a destination line number for an EDLIN C (Copy) or M 
(Move) command. Enter a destination line number when you try again. 


Name of list device [PRN]: 
MS-DOS displays this message if you do not specify a device the first time 
you use the PRINT command. Press RETURN to select the default value (PRN) 
or enter a device name. 


Network support loaded 

Unable to FDISK 
The FDISK cannot be used to modify a fixed disk used as part of a network. 
Restart MS-DOS without network support and retry the command. 


No files match d:\path\fi/lename.ext 
You have entered a file specification with the PRINT command, but no files 
match your entry. Check your filenames and try again. The message only 
appears if there are files in the print queue. 
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No free file handles 

Cannot start COMMAND.COM, exiting 
You have attempted to load a secondary command processor using COMMAND, but 
there are too many files open. Increase the number in the FILES command in 
your CONFIG.SYS file and restart the system. 


No object modules specified 
You did not enter an object module filename when you started MS-LINK. 


No paper 
See the Device Errors and Disk Errors sections in this Appendix. Thé 
printer specified is out of paper or off-line. Replace the paper, turn the 
printer ON, or press the printer ONLINE or SEL switch. 


No room for system on destination disk 
The SYS command displays this message when there is not enough room on the 
target disk for the IO.SYS and MS-DOS.SYS system files. You are probably 
using different versions of MS-DOS. 


No room in directory for file 
The directory of the disk specified in EDLIN is already full, or the 
specified disk drive or filename is illegal. Use another disk or check 
your entry and try again. 


No room in root directory 
Your attempt to use the LABEL command has failed because there is no room 
in the directory for another entry. Delete a file from the root directory 
and retry. 


No subdirectories exist 
The TREE command displays this message to indicate that the specified drive 
contains only a root directory. 


Non-DOS disk 
See the Device Errors and Disk Errors sections in this Appendix. The disk 


contains invalid information in the File Allocation Table. Reformat the 
disk. 


Non-System disk or disk error 

Replace and strike any key when ready 
The disk you are using to start MS-DOS does not contain the system files, 
or an error occurred when attempting to read the disk. Make sure the disk 
is a system disk and retry the command. 


*** Not able to back up file *** 
One of the files specified in the BACKUP command was in use by another 
operator on the network when the backup was performed. It was not saved. 
Retry the BACKUP command at a later time using the /M option. 


*** Not able to restore file *** 
One of the files specified in the RESTORE command could not be opened 
because it was in use by another operator on the network. It was not 
restored. 
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Not enough memory 
There is not enough memory available to run the command. Restart MS-DOS 


and delete memory-resident programs (PRINT, GRAPHICS, and so on) to 
increase available memory. 


Not enough room to merge the entire file 
There was not enough room in memory to hold the file specified in an EDLIN 
T (Transfer) command. Free additional memory by deleting some files or 
saving them on disk. 


Not found 
EDLIN was unable to find another occurrence of the string specified in a S 
(Search) or R (Replace) command. 


Not ready 
See the Device Errors and Disk Errors sections in this Appendix. The 
device you've selected is not ready for the read or write operation you've 
requested. Check the device and try again using the R (Retry) option. 


am eu, 


This message appears following an EDLIN S (Search) or R (Replace) command. 
If you press any key except Y or RETURN, the Search or Replace process 
continues. 


Out of environment space 
There is not enough room in the MS-DOS environment buffer to accept more 
data. When using the COMMAND, PATH, PROMPT, or SET commands, this message 
indicates that the command was not stored in the environment. To create a 
larger environment area, restart the system and use SET or other commands 
before loading memory-resident programs like MODE, PRINT, and GRAPHICS. 


Out of space on list/run/scratch/VM.TMP file 
MS-LINK displays this message when there is not enough disk space for the 
file specified. Use a disk with more free space. 


Parameters not compatible 
Two incompatible options were specified with the FORMAT command (for 
example, /B and /V). Review the FORMAT command in Chapter 5. 


Parameter not compatible with fixed disk 
The /1 or /8 option was specified when attempting to FORMAT a fixed disk. 
Review the FORMAT command in Chapter 5. 


Path not found 


The path specified in a command does not exist in the directory of the 
drive specified. 


Pathname too long 


The path specified in the PRINT command exceeds the maximum length of 64 
characters. 
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Please replace original diskette 

in drive d: and press ENTER 
If the /P option is specified, MS-LINK displays this message after writing 
the .EXE file. Insert the disk containing the list file and press RETURN. 


Press any key to begin recovery 

of the files on drive d: 
Insert the disk you want to RECOVER in the drive specified and press any 
key to continue. 


PRINT queue is empty 
There are no files in the print queue. Files must be placed in the print 
queue by the PRINT command before they can be printed. 


PRINT queue is full 
You attempted to place more than ten files in a print queue. Wait until 
files already in the queue are printed or change the default limit of 10 
with the PRINT command. 


Probable non-DOS disk 

Continue (Y/N)? 
The disk you are attempting to check may not be an MS-DOS disk. Indicate 
whether or not you want CHKDSK to continue. 


Processing cannot continue 
There is not enough memory available to run CHKDSK. Free additional memory 
by deleting memory-resident commands like PRINT and MODE and retry the 
command. 


Program too big to fit in memory 
The command or program you attempted to load is too large to fit in the 
memory available. Free additional memory by deleting memory-resident 
commands like MODE, PRINT, and GRAPHICS, or reset the BUFFERS command in 
your CONFIG.SYS file to a lower value and restart MS-DOS. If you still 
receive this message, you may have to upgrade your computer's memory. 


Read error in f//ename 
The command you've entered could not read the entire file. Try again. If 
the problem persists, try RECOVER. 


Read fault 
See the Device Errors and Disk Errors sections in this Appendix. MS-DOS 
cannot read the requested data from the named device. Check your entry and 
try again. 


Resident part of PRINT installed 
This message is displayed the first time you issue the PRINT command. It 
indicates that the memory-resident portion of PRINT has decreased the 
amount of memory available by several thousand bytes. 
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Resident portion of MODE installed 
This message is displayed when you use certain options of the MODE 
command. It indicates that the memory-resident portion of MODE has 
decreased the amount of memory available. 


Restore file sequence error 
The file specified in RESTORE was not restored because the backup disks 
were not inserted in sequential order. Rerun the RESTORE command. 


sector not found 
See the Device Errors and Disk Errors sections in this Appendix. The 
sector containing the requested data cannot be found or cannot be read. 
This is usually due to a bad sector on the disk. Try to RECOVER the disk. 
If this does not solve the problem, the data is lost. 


Sector size adjusted 
The VDISK.SYS command has adjusted the number of sectors specified in your 
CONFIG.SYS file to accommodate system requirements. No action is required. 


sector size too large in file f//ename 
The filename in the DEVICE command in your CONFIG.SYS file specifies a 
sector size larger than any other device driver on the system. Reduce the 
sector size in the device driver file. 


seek error 
See the Device Errors and Disk Errors sections in this Appendix. The disk 
drive cannot find the proper track on the disk. Try again. If the problem 
persists, the disk is probably damaged and cannot be recovered. 


Segment limit too high 
MS-LINK cannot allocate the number of segments requested because of 
insufficient memory. Set the /X option to a smaller value and rerun 
MS-LINK. 


Segment size exceeds 64K 
MS-LINK attempted to combine segments with the same name, resulting in a 
segment block larger than 64K. Change the segment names in the object 
modules and rerun MS-LINK. 


SHARE already installed 
You attempted to install the SHARE command a second time. No further 
action is necessary. 


Sharing buffer exceeded 
Requests for files exceeded the file sharing and block locking buffer 
size. Wait until fewer users are sharing files or increase the buffer size 
for your particular network. ' 


Sharing violation 
See the Device Errors section in this Appendix. An attempt was made to 
share a file using an invalid SHARE mode. Some other operator on the 
network may have the file open. Use the R (Retry) option. If that doesn't 
work, use the A (Abort) option and retry at a later time. 
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Source and target diskettes are not the same format 

Cannot do the copy 
The DISKCOPY command requires the same type of disks; for example, you 
cannot copy a double-sided disk to a single-sided disk. 


Source and target drives are the same 
The same drive was specified as both source and target in the BACKUP or 
RESTORE commands. Specify a different drive. 


Source diskette bad or unusable 
The DISKCOPY command found errors on the source disk after the copy was 
completed. Use DISKCOMP to insure the copy was successful. 


Source does not contain backup files 
The source disk you inserted with the RESTORE command does not contain 
files created using BACKUP. Check the disk and retry. 


Specified command search directory bad 
This message is displayed when the drive and path specified with COMMAND 
are invalid. MS-DOS sets the COMSPEC statement in the CONFIG.SYS file to 
the default value. 


Specified drive does not exist, 

or is non-removable 
The drive specified in DISKCOMP or DISKCOPY does not exist or is a fixed 
disk. Specify a valid drive and retry. 


Specified MS-DOS search directory bad 
This message is displayed when the path specified in the SHELL command in 
the CONFIG.SYS file is invalid. 


Syntax error 
The command you entered was incorrect. Check Chapter 5 for the proper 
syntax. 


System files restored 

The target disk may not be bootable 
The system files IO.SYS and MSDOS.SYS were successfully copied by the 
RESTORE command, but the disk may not be bootable because they are from a 
different version of MS-DOS. Use the SYS command to transfer MS-DOS system 
files to the disk and then use the COPY command to transfer COMMAND.COM. 


System transferred 
This message is displayed after the SYS and FORMAT /S commands have 
successfully copied the system files to the target disk. 


Target can not be used for backup 
The BACKUP command was unable to create files on the target disk. Replace 
the disk and retry or use a different target device. 


Target diskette bad or unusable 


The DISKCOPY command detected irrecoverable errors in the target disk 
during the copy. Use another disk and rerun the command. 
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Target diskette may be unusable 
The DISKCOPY command found errors on the target disk after the copy was 
completed. Use DISKCOMP to insure the copy was successful. 


Target diskette write protected 

Correct, then strike any key 
DISKCOPY displays this message when the target disk is write protected. 
Remove the tab, reinsert the disk, and press any key to continue. 


Target does not contain backup files 
The disk specified in the BACKUP /A command does not contain files created 
in a previous backup. 


Target is full 
The disk the RESTORE command is writing to is full. Delete any unnecessary 
files and retry, or use another disk. 


Terminate batch job (Y/N)? 
If you press CTRL C or CTRL BREAK during the processing of a batch file, 
MS-DOS asks you to confirm by typing Y (yes). Type N (no) to continue 
processing the batch file. 


The last file was not restored 
The RESTORE command was stopped before completion or there was not enough 
room on the fixed disk and RESTORE deleted the last file. 


Too many block devices 
The DEVICE parameter in the CONFIG.SYS file specifies more than 26 block 
device units. Change the value and restart the system. 


Too many files open 
EDLIN could not open the file due to a lack of file handles. Increase the 
value of the FILES command in the CONFIG.SYS file. 


Top level process aborted, cannot continue 
MS-DOS displayed a disk error during startup and you chose the A (Abort) 
option. The error in COMMAND.COM is irrecoverable; restart the system with 
another MS-DOS disk. 


Track O bad -- disk unusable 
The FORMAT command detected an irrecoverable error at the beginning of the 
target disk. It cannot be fixed using CHKDSK; use another disk. 


Unable to create directory 
The MKDIR command could not create the directory you specified. Check to 
see whether the disk is full or the directory name already exists. 


Unable to write BOOT 


The FORMAT /S command detected an irrecoverable error in the MS-DOS sector 
of the target disk. It cannot be fixed using CHKDSK; use another disk. 
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Unrecognized command in CONFIG.SYS 
There is an invalid command in your CONFIG.SYS file. Review Chapter 7 and 
correct the error. 


Unrecoverable error in directory 

Convert directory to file (Y/N)? 
CHKDSK detected an irrecoverable error while checking the directory. If 
you type Y (YES), the directory will be converted into a file so you can 
fix or delete it. 


Unrecoverable file sharing error 
A file sharing conflict occurred. The files are damaged and cannot be 
restored. 


Unrecoverable read error on source 
The DISKCOPY command is unable to read data on the source disk after 
several tries but continues processing. Use DISKCOMP to insure the copy 
was successful. 


Unrecoverable write error on target 
The DISKCOPY command was unable to write data on the target disk after 
several tries but continues processing. Use DISKCOMP to insure the copy 
was successful. 


ll! WARNING EN 
You are formatting the hard disk 
THIS WILL DESTROY ALL DATA ON THE HARD DISK 


Enter Y to continue, any other key 
will cancel the request to format. 


Do you wish to format the hard disk? 
MS-DOS displays this message when you attempt to use the FORMAT command to 
format the fixed disk. If you type Y (YES), all data currently stored on 
the fixed disk will be destroyed. Type N (NO) to terminate the command. 


Warning! Data in the DOS partition 

could be DESTROYED. Do you wish to 

GO t UB. acusa dares 2-4 
When you choose the FDISK Delete DOS partition option, MS-DOS displays this 
warning message. All data contained in the DOS partition on the fixed disk 
will be destroyed if you proceed. To continue formatting the fixed disk 
(thus deleting the existing DOS partition), type Y and then press RETURN. 
If you simply press RETURN, the DOS partition will NOT be deleted. 


Warning -- directory full 
The RECOVER command displays this message when there is not enough 
directory space to recover all files. Delete some files or copy them to 
disk and retry the command. 
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Warning! Diskette is out of sequence 

Replace the diskette or continue 

Strike any key when ready 
One of the disks you inserted for the RESTORE command is out of sequence. 
If you want to restore the files on the skipped disk, you must insert it 
before pressing a key. 


Warning! File f//ename 

is a read only file 

Replace the file (Y/N)? 
One of the files specified with the RESTORE /P command is read-only. Type 
Y (YES) if you want RESTORE to replace it with the backup file; type N (NO) 
to retain the original. RESTORE continues when you press RETURN. 


Warning! File #//ename 

was changed after it was backed up 

Replace the file (Y/N)? 
One of the files specified with the RESTORE /P command has a later date and 
time on the target disk than on the source disk. Type Y (YES) to replace 
it with the older backup file; type N (NO) to retain the changed file. 
RESTORE continues when you press RETURN. 


Warning! Files in the target 

root directory will be erased 

Strike any key when ready 
The RESTORE command displays this warning message when files in the target 
root directory are about to be erased. To terminate the command, press 
CTRL BREAK. 


Write fault 
See the Device Errors and Disk Errors sections in this Appendix. MS-DOS 
cannot successfully write data to the named device. Check your entry and 
try again. 


Write protect 
See the Device Errors and Disk Errors sections in this Appendix. You have 
tried to write data on a write-protected disk. Check the disk to be sure 
that you want to write to it. If so, remove the write-protect tab. 
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xxx lost clusters found in yyy chains 

Covert lost chains to files (Y/N)? 
CHKDSK has found lost clusters on your disk. These may be parts of data 
files that have somehow been separated from their original files. If you 
type Y (YES), the clusters are written into files placed in the root 
directory under the name(s) FILEnnnn.CHK. You can then attempt to repair 
damaged files or delete these safety files. CHKDSK then responds with: 


n bytes disk space freed 


If you type N (NO) and have not specified the /F option of CHKDSK, the 
clusters are not freed, and the following message is displayed: 


n bytes disk space would be freed 
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A B 
A (Append command/EDLIN) 8-7, 8-8 /B Option (EDLIN) 8-4 
A (Assemble command/DEBUG) 10-7 Background printing 5-87 
Address BACKUP 3, 1-8, 3-7, 5-13, 1-9 
changing 10-13 exit codes 5-14 
memory contents displayed 10-10 options 5-14 
of clock driver 7-11 warning 5-13 
ANSI escape sequences with RESTORE 1-8, 5-98 
cursor control functions A-3 Bad Flag 10-35 
erase functions A-S Bad Register 10-35 
escape parameters A-6, A-7 Bad sector, RECOVER 5-94 
installing ANSI.SYS A-1 Batch files 
issuing A-2 AUTOEXEC.BAT 6-5 
keyboard reassignment A-8 branching 6-13 
modes of operation A-S commands 
purpose A-1 ECHO 6-9 
syntax A-1 FOR 6-13 
ANSI.SYS A-1 GOTO 6-15 
Append command (EDLIN) 8-7, 8-8 IF 6-16 
Append files 5-34, 5-36 PAUSE 6-11 
ASCII dump 10-10 REM 6-12 
Assemble command (DEBUG) 10-7 conditional 6-13 
Assembly language mnemonics 10-7 COPY CON 6-2 
ASSIGN 5-9 creating 6-2 
caution 5-10 definition 6-2 
reassigning drives 5-9 display commands 6-9 
ATTRIB 2, 1-9, 5-11 editing 6-3 
AUTOEXEC.BAT 3-6, 6-5 EDLIN 6-3 
and keyboard driver 2-9, 5-61, looping 6-13 
6-5 replaceable parameters 6-6 
and Keybxx 5-103, 5-104, 6-5 running 6-3 


and SELECT 2-9 SHIFT 6-8 


Belgium, country code 7-6 


BF 10-35 

Binary files, editing 10-2 

BP 10-35 

BR 10-35 

Branching, in a batch file — 6-13 
BREAK 5-16, 7-4 


Breakpoint address(es) 10-14 
Breakpoints 10-35 

BUFFERS 7-5 

Byte values 10-4 


C 


C (Compare command/DEBUG) 10-9 
C (Copy command/EDLIN) 8-7, 8-9 
CD (see CHDIR) 
CHDIR 3-5, S-18 
CHKDSK 1-3, 1-4, 1-9, 5-21 
options 5-22 
status report 5-21 
with COPY command 5-21 
CHMOD 1-9, 5-24 
Clock 2-9, 7-11 
and CONFIG.SYS 
7-11 
and CLKDVR.SYS 2-9, 5-104, 7-11 
Clock driver 2-9, 5-104, 7-2 
address in memory 7-11 
and CONFIG.SYS 2-9, 5-61, 5-104, 


2-9, 5-104, 7-2, 


7-2, 7-11 
on a network 2-10 
CLS 5-26 


Code segment register 10-14 
COLOR 5-27 
Combining files 5-36 
COMMAND 5-28 

options 5-29 


Commands 5-2, 5-5 
ASSIGN 5-9 
ATTRIB 2, 1-9, 5-11 
BACKUP 3, 3-7, S-13 
BREAK 5-16, 7-4 
CHDIR 3-5, 5-18 
CHKDSK 1-3, 1-4, 1-9, 5-21 
CHMOD 1-9, 5-24 
CLS 5-26 
COLOR 5-27 
COMMAND 5-28 
COMP 5-31 
COPY 1-7, 1-8, 1-9, 2-10, 5-34 
COPY CON 6-2 
CITY 4-3, 5-40 
DATE 5-42 
DEL 5-44 


DIR 1-3, 5-46 
DISKCOMP 1-7, 1-9, 5-48 
DISKCOPY 1-7, 1-9, 5-51 


EXE2BIN 5-54 

EXIT 5-56 

FDISK 2-2, 2-3, 2-5, 5-57 
FIND 5-58 

FORMAT 5-60 

GRAFTABL 2, 5-63 
GRAPHICS 5-64 

in a subdirectory 3-6 


JOIN 2, 5-66 

KEYBxx 2, 5-70, 5-104, 6-5 
LABEL 2, 2-8, 5-72 

MD (see MKDIR) 

MKDIR 3-4, 5-74 

MODE 5-76 

MONO 5-81 

MORE 5-82 


on a network 5-5 
parameters 5-4 
PATH 3-5, 3-6, 5-84 


piping 4-5 
PRINT 5-87 
PROMPT 3-7, 5-90 


RD (see RMDIR) 
RECOVER 5-94 


separators 5-4 


SET 5-106 
SHARE 2, 5-109 
SIZE 5-111 
SORT 3, 5-113 
SUBST 3, 5-116 
syntax 5-2 

SYS 5-119 
table 5-5 

TIME 5-121 
TREE 3, 3-7, 5-124 
TYPE 5-127 


VDISK , 3, 5-129, 7-8, 7-9, 7-10 
VER 5-131 

VERIFY 5-132 

VOL 5-133 

XASSIGN 5-134 

XTREE 5-138 

-COM 2-11 

COMMAND.COM 3-6 

COMP 5-31 

Compare command (DEBUG) 10-9 
Complete file specification 5-3 
Complete path specification 5-4 


Conditionals, in a batch file 6-13 
CONFIG.SYS 3, 2-9, 3-6, 5-104, 7-2, 


Clockdriver 3, 2-9, 5-61, 5-104, 
7-2, 7-11 

Commands 
BREAK 7-4 


BUFFERS 7-5 
COUNTRY 7-6 
DEVICE 7-8 
FCBS — 7-12 
FILES 7-14 
LASTDRIVE 7-15 
SHELL 7-16 
creating 7-3 
sample file 7-17 
VDISK.SYS 7-8, 7-9, 7-10 
COPY 1-7, 1-8, 1-9, 2-10, 5-34 
append files 5-34, 5-36 
options 5-37 
COPY CON 6-2 
Copy command (EDLIN) 8-7, 8-9 
COUNTRY command, in a CONFIG.SYS 
file 2-9, 7-6 
Country code 2-9, 5-103, 5-104,7-6 
and CONFIG.SYS 2-9, 5-103, 5-104 
CPU registers 
display contents 
editing 10-2 
Creating EDLIN files — 8-2 
CITY 5-40 
caution 5-40 
Current directory 


10-26 


1-4, 3-3 


D 
D (Delete command/EDLIN) 8-7, 8-11 
D (Dump command/DEBUG) 10-10 
DATE 5-42 
DEBUG 10-2 
command summary 10-33 
commmands 


A (Assemble) 10-7 
C (Compare) 10-9 


D (Dump) 10-10 
E (Enter) 10-11 
F (Fil 10-13 
G (Go) 10-14 

H (Hex) 10-16 
I (Input) 10-17 
L (Load) 10-18 
M (Move) 10-20 


N (Name) 
O (Output) 
P (Proceed) 10-24 
Q (Quit) 10-25 
R (Register) 10-26 
S (Search) 10-28 
T (Trace) 10-29 
U (Unassemble) 
W (Write) 10-32 
default segment 10-3 
error messages 10-35 
parameters 10-3 
definitions 10-3, 10-4, 10-5 
address 10-3 
byte 10-3 
drive 10-3 
list 10-3 
portaddress 10-4 
range 10-4 
record 10-4 
registername 10-4 
sector sector 10-4 
string 10-5 
value 10-5 
prompt 10-3 
starting 10-2 
stopping execution 10-6 
syntax error 10-6 
DEL 5-44 
warning 5-44 
Delete command (EDLIN) 
Delimiters 10-3 
Denmark, country code 
DEVICE 
and ANSI.SYS 7-8, 7-9 
and CLKDVR.SYS 7-8, 7-11 
and clock driver — 7-11 
and VDISK.SYS 7-8, 7-9, 7-10 
Device drivers 7-8..7-11, A-1 
DF 10-35 
DIR 1-3, 5-46 
options 
Directing files to a system device 
5-36 
Directory 1-2, 3-2 
accessing 3-5 
changing 3-5 
creating levels 3-4 
current 1-4, 3-3 
damaged 5-94 
displaying contents 
5-138 
entries 3-3 
multilevel 3-2, 3-4 
naming conventions 3-4 
parent 3-3, 3-4 


10-21 
10-23 


10-30 


8-7..8-11 


3-3, 5-124, 


path 3-4 
removal 3-5, 5-101 
root 3-2, 3-3 
subdirectories 3-2 
working 3-3 
Disassembling 10-30 
Disk 
directory 1-2 
fixed 2-2, 3-2 
source 1-7 
target 1-7 
Disk buffers 7-5 
Disk sectors, loading 10-18 
DISKCOMP 1-7, 1-9, 5-48, 10-2 
options 5-49 
DISKCOPY 1-7, 1-9, S-S1, 5-104 
options 5-52 
Display commands 6-9 
Display mode 5-77 
Double flag 10-35 
Drive 
indicator 1-3 
name, substituting 5-116 
Dump command (DEBUG) 10-10 


E 


E (End command/EDLIN) 8-14 
E (Enter command/DEBUG) 10-11 
ECHO 6-9 
Edit command (EDLIN) 8-7, 8-14 
EDLIN 5-104 
about 8-2 
/B option 8-4 
commands 8-9 
A (Append) 8-7, 8-8 
C (Copy 8-7, 8-9 
D (Delete) 8-7, 8-11 
E (End) 8-4, 8-13 
Edit 8-7, 8-14 
I (Insert) 8-7, 8-16 
L (List) 8-7, 8-17 
M (Move) 8-7, 8-18 
P (Page) 8-7, 8-19 
Q (Quit) 8-7, 8-4, 8-20 
R (Replace) 8-7, 8-21 
S (Search) 8-7, 8-23 
T (Transfer) 8-7, 8-25 
variables in 8-6 
W (Write) 8-7, 8-26 
creating files 8-2 
editing files 8-3 
error messages 8-27 
leaving 8-4 
line numbers 8-5 
Starting — 8-2 


End command (EDLIN) 8-7, 8-13 
Enter command (DEBUG) 10-11 
Environment 5-106 
ERASE (see DEL) 
Error messages 
EDLIN 8-27 
DEBUG 10-35 
device B-1 
disk — B-2 
list B-3 
MS-LINK 9-18 
EXE2BIN 5-54 
EXIT 5-56 
Extension 1-3, 1-4 
filename 1-4, 1-5 
.COM 2-11 


F 


F (Fill command/DEBUG) 10-13 
FAT (see File Allocation Table) 
FCBS 7-11 
FDISK 2-2, 2-3, 2-5, 2-11, 2-12, 
5-57 
changing 2-5 
creating 2-3 
cylinders 2-2 
definiton 2-2 
deleting 2-6 
displaying 2-6 
formatting 2-7, 2-8 
MAP 2-6 
MS-DOS | 2-2..2-7 
more than one operating system 
2-3, 2-4 
one operating system 2-3 
options 2-3, 5-58 
partitions 2-2 
File Allocation Table 1-2, 1-3, 
1-4, 1-9 
File Control Block 7-12 
File handle 7-14 
Filenames 1-2, 1-3, 1-4 
conventions 1-5 
extension 1-3, 1-4 
reserved 1-5 
settings 10-21 
wild cards 1-6, 1-7 
write protection 1-9 
Files 
about 1-2 
ATTRIB 1-9 
attributes 1-9 
backing up 1-7 
binary 5-54, 5-55 


CHKDISK 1-3, 1-4, 1- 

CONFIG.SYS 3-6, 7-3 

configuration file 7-2 

copying 2-10 

DIR 1-3, 5-46 

directory 1-2, 3-2 

displaying contents 3-3, 5-111, 
5-127 

editing 10-2 
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